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° Support is added for IBM LU2-type terminals. 
* There are nine new object modules: IKTIMLU2, IKTOMLU2, IKT3270I, 
IKT32700, IKTATIN, IKTEXIT, IKTIOFRR, IKTOOO9D, and IKTISTOO. 
IKTIMLU2 and IKTOMLU2 manage terminal input and output for IBM 
LU2-type terminals. IKT3270I and IKT32700 handle data input and 
output for all 3270 terminals. IKTATTN, IKTEXIT, and IKTIOFRR 
perform service functions for all 3270 terminals and are used by 
IKTIMIDS, IKTOMIDS, IKTIMLU2, and IKTOMLU2. IKTOO0O09D determines 
the appropriate branch for terminal control macros, and IKTISTOO’ 
schedules the lost terminal exit routine. 


e There are two new load modules: IKTIOMOO and IKTIOMO3. IKTIOMOO 
contains IKTEXIT, IKTIOFRR, and IKTISTOO. IKTIOMO3 contains 
IKTIMLU2 and IKTOMLU2, IKTATTN is in IKTIOMO2, and IKTOO09D is in 
TGCOOQ9D. 


EREFACE 


This publication describes the internal organization and logic of the 
VTAM terminal I/O coordinator (VTIOC) and the terginal control address 
space (TCAS). It is intended for people who are debugging or modifying 
VTICC or TCAS. 


This book is actually twe manuals in one; VTIOC and TCAS each have 
introduction, method of operation, program organization, directory, 
data areas, and diagnostic aids sections. In addition, there are two 
appendixes. Following is a synopsis of the information contained in 
this panual: 


e The introduction secticns frovide overviews of VTIOC and TCAS, and 
summarize the functions they perforn. 


e The method of operaticn sections use HIPO (hierarchy plus 
input-process-output) diagrams to describe the functions perforsed. 


e The program organization sections provide descriptions of each nodule 
and diagrams showing module-to-sodule control flow. 


e The directory sections list module names, show their relaticnshifs 
to each other, and provide references to other sections in the manual 
where the modules are described. 


e The data areas sections contain diagrams showing the relationships 
aacng VTIOC and TCAS control blocks and work areas, and descriptions 
of several key internal data areas. 


e The diagnostic aids sections list the modules that issue, detect, 
and contain VTIOC and TCAS gsessages. The TCAS diagnostic aids 
section also describes how TCAS records errors. 


e Appendix A gives the meanings of all abbreviations used in this 
Fublication. 


e Appendix B provides information about installation-written exit 
routines. 


The reader should be familiar with the information presented in the 
fcllcwing fublication: 


QOS/VS2 MVS TSO/VIAM System Information, GC27-0046, which contains 


a complete list of the publications that support TSO/VTAM and 
the appropriate selectatle unit (SU) supplement order numbers. 


Additonal information is available in the following publications: 


OSZVS2 System Logic Library (7 volumes), SEOF-8210 

CS/VS2 System Data Areas (microfiche), SYB8-0606 

OSZVS2 System Programming Library: Debugging Handbook (2 volumes), 
GBOF-8211 


QSZYS2 TCAN Logic, S¥30-2040 


OS/VS Message Library: VS2 System Messages, GC38-1002 
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OSZVS Message Library: VS2 Sys 

OS/VS2 TSO Guide to Writing aT 
Processor, GC28-0648 

OS/VS2 Data Area Usage Table (microfiche), SYB8-0742 

OS/V¥S2 Symbol Usage Table (microfiche), SYB8-0744 


tem Codes, GC38-1 
eItminal Monitor Program or a Coppapd 
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COMPONENTS 


The VTAM terminal I/O coordinator (VTIOC) controls the movement of 
data between TSO and a user terminal in a TSO/VTAB time-sharing 
environment (see Pigure 1). VTIIOC has five functional cosponents: 


e Initialization/termination routines. Initialization routines 
allocate storage for and initialize VTIOC and VTAM control blocks, 
the input and output gueues, and the I/O manager SRBs. They also 
ccnnect user terminals to ISO. Termination routines free storage 
and disconnect user terminals from TSO. 


e TGET/TPUT routines (SVC 93). These routines handle the movement of 
data between TSO and the terminal, principally by using the services 
of the terminal I/O managers and the queue manager. 


e Terminal I/O managers. Terminal input managers (TIMs--two for IBM 
3270 LUO and LU2 terminals, one for IBM 3767 and IBM 3770 terminals) 
obtain input from the terminal for placement on the input queue by 
issuing the RECEIVE macro. Terminal output managers (TOMS--two for 
IBM 3270 LUO and LU2 terminals, one for IBM 3767 and IBM 3770 
terminals) send output from the output queue to the terminal by 
issuing the SEND macrc. 


e Cueue manager. The queve manager adds elements to and removes 
elements from the input queue and the output queue. 


e Tergpinal control pacre routines (SVC 94). These routines allow a 
command processor to control terminal functions and attributes. 


Host CPU 


User Address Spaces 


VTILOC 


Terminals e Initialization/ e Terminal 
Termination Monitor 
TGET/TPUT Program 


@e Command 
Processors 


Terminal |/O 
Manager 


-e Service 


Queue Manager 
Routines 


@ Terminal 
Control Macros 


Figure 1. The Major Elements in a TSO/VTAM Tiwe-Sharing Systen 


VTIOC Introduction 1 


The basic function of VTIOC is to respond to TGET and TPUT requests. 
ISC issues a TGET reguest to ortain input from a terminal. VTA ensures 
that the input is available in VTAM's buffer. The terminal input 
panager, which is scheduled as a service request block (SRE) during 
VTIOC initialization and is always active, issues a RECEIVE macro to 
meve the input from VTAM's buffer to the terminal input manager's 
tuffer. (Because the terminal input manager iS always active a RECEIVE 
reguest is always outstanding.) The input queue manager takes the input 
from the terminal input manager's buffer and puts it on the input queue 
in one or more queue elements. The VTIOC TGET routine takes the data 
frca the input gueue, edits it if requested, and soves it to the TGET 
reguester's (TSO's) buffer. 


1SO issues a TPUT reguest to send output to a terminal. The VTIOC TPOT 
routine reguests the outfut queue manager to sove the output from the 
TEUT requester's (TSO's) buffer to the output queue. It then schedules 
the terminal output manager (as a SRB) which issues a SEND macro to 
send the output to a VTAM buffer. VTAM ensures that the output moves 
frce its buffer to the terminal. 


TERMINALS SUPPORTED 
The following terminals are supported by TSO/sVTA&: 
Lccal terminals: 


IEM 3270 Information [Cisplay Systen: 


e 3272 Control Unit Mcdels 1 and 2 with attachable 3277 Display 
Station Models 1 and 2 


e 3274 Control Unit Mcedels 1A (SNA) and 1B (non-SNA) with 
attachable 3277 Display Station Models 1 and 2 or 3278 Display 
Staticn Models 1***, 2, 3**, 4** (Model 1A for Level 2 only) * 


IBM 3790 Comgunicaticn System (TSO/VTAM Level 2 only):* 


e 3791 Controller Models 1A, 1B, 1C, 2A, and 2B, with attachable 
3277 CLisplay Station Models 1 and 2, or 3276 Control Unit 
Display Staticn Model 12 (optionally with attachable 3278 
Display Staticn Model 2) 


ESC terminals (cn nonswitched lines): 
IBM 3270 Information Cisplay System: 


e 3271 Control Unit Models 1 and 2 with attachable 3277 Display 
Station Models 1 and 2 


e 3274 Control Unit Mcdel 1C with attachable 3277 Display 
Station Models 1 and 2 or 3278 Display Station Models 1***%, 
Z, 3**, Yon 


e 3275 Display Station Models 1 and 2 
° 3276 Control Unit Display Station Models 1***, 2, 3**, \** 


(Optionally with attachable 3278 Lispflay Station Sodels 1***, 
2, 3**, Yee) 


SCLC Terminals: 
IBM 3270 Information [isplay System on nonswitched lines: 


e 3271 Control Unit Mcdels 11 and 12 with attachable 3277 
Display Staticn Models 1 and 2 


e 3274 Control Unit Model 1C (Level 2 only)* with attachable 
3277 Display Station Models 1 and 2 or 3278 Display Station 
Models 1***, 2, 3**, Yee 


e 3275 Display Station Models 11 and 12 


@ 3276 Contrcl Unit Display Station Models 11***, 12, 13¥**, 
14** (opticnally with attachable 3278 Display Station HWodels 
1##*, 2, 3**, 4**) (Level 2 only) * 


IBM 3767 Communication Terminal Models 1, 2, and 3 
IEM 3770 Data Communication Systen: 
e 3771 Communication Terminal Models 1, 2, and 3 
e 3773 Communication Terminal Models 1, 2, and 3 
° 3774 Coapunication Terminal Models 1 and 2 
° 3775 Communication Terminal Model 1 
IBM 3790 Communicaticn System (TSO/VTAM Level 2 only):* 


e 3791 Contrcller Models 1A, 1B, 1C, 2A, and 2B, with attachable 
3277 Display Station Models 1 and 2, or 3276 Control Unit 
Display Staticn Model 12 (optionally with attachable 3278 
Display Staticn Model 2) 


In the above list, and throughout this publication, different terminal 
tyres have different classifications based on their logical unit (LU) 
Fresentation services prcfile. The LU profile represents a type of 
logical unit that uses a unique subset of the SNA-defined protocols 
and data streams for its operation. Terminal groups in the akove list 
marked with an asterisk (*) are classified LU2. The remaining 
3270-series terminals are LUO, while the 3767 and 3770 grourfs are LU1. 
For further information, see VTAM Macro Language Reference, GC27-6995. 


*LU2 device 
**Supforted as a 1920-character display station 
***#Supported as a 480-character display station 
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This section uses the HIFO (hierarchy plus input-process-outrfut) 
technigue to graphically describe the functions performed by VTIOC. 
It contains a visual table of contents and diagraas. 


The visual table of contents (Figure 3) contains the names and 
identification numbers of all the diagrams. There is a diagram for 
each VTIOC routine. (A routine is a functional unit of processing 
identified by an object module name or an alternate entry point name.) 
The level cf detail of the diagrams is such that they show the. function 
rerformed by each routine, calls to other routines, and significant 
inputs and outputs; they do nct show organization of a routine or . 
Frocessing flow within a routine. 


Conventions Used in HIPO Liagrags 

At the top of each diagram is a diagram ID consisting of an 
identification number (MO nupker), a routine name, and a description 

cf the routine. The identification number provides a way of locating 

a diagram through the visual table of contents or the directory ("VTIOC 
Lirectory"). Below the diagram ID are input-process-output Elocks and 
extended description blocks. 


Ihe input block shows data that serves as input to the processing steps 
in the processing block; the cutput block shows data that 1s output 

frcm the processing steps. The symbols used in and between these blocks 
are explained in the legend below (see Figure 2). Each processing step 
is numbered; the number corresponds to a note in the extended 
description block. The ncetes frovide additional information for the 
processing steps. The routine name and labels identify the code that 
ferforms the function of each step. The references column gives the 

MC numbers of related diagrams. 
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Control flow — main entry to a diagram 


Control flow — main exit from a diagram 

Control flow — alternate exit from a diagram 
Control flow — exit from and reentry to a diagram 
Control flow — on-page connection 


Data movement 


Data pointer ) 


Data reference 


N 
pills A data area. Note that the size of a data area box has no functional 
significance; it is determined by the amount of information to be 
placed in the box. 
Name 


Field Name By eee j 
A data area containing one significant field 


Figure 2. Legend for HIFO Figures 
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3270 LUO Terminal Input 
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Manager (IK TTIMRT) 
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Branching Routine (IK TOOO9D) 
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MO 1.1 VTIOC Initialization Routine (IKTXINIT) 


input From LOGON 
Tnitialization 


(IKJEPLA) 


This routine initializes VTAM control 
blocks and the TYWA, and transfers 
control of the terminal from TCAS to 
the terminal user’s address space. 


Each terminal user's address space |IKTXINIT 
has a TVWA, ACB, EXLST, ‘RPL, and 
NIB associated with it. A GETMAIN 
macro is used to obtain storage 
from subpool 229 (key 6): the 
etorage is initialized with the 
following values: 
TVWA 
* TCB 
? NIB 
t RPL 
t EXLST 
t variable storage area 
' local iock work area 
1 IXTIIOM or IKTINK2 


Size of variable storage area 


user's application ID 


Aca 
t application ID 
password 
NIB 
terminal ID 
t TSB 
RPL 
f ACB 
+ NIB 
t IKTRPLXT 
EXLST 
+ JXTLTERM 


The user address space index placed 
in the TSBX by TCAS (TSBXAIND) is 
used to create the unique application 
ID assigned to the terminal user's 
address space. The application IND is 
stored in TVWAPPL. 


Processing 


Output 


Allocate storage for and : NIB EXLST 
initialize a TVWA and the 

VTAM control blocks 

necessary for a terminal 


session. 


Identify the terminal 
user's address space to 
VTAM as a VTAM applica- 
tion program. 


Establish connection 
between TSO and the 
terminal. 


Transfer control of the 

terminal from TCAS to the 

terminal user's address 

space. 

Input and 
output 
queues 


Allocate storage for the 
queve manager's input 


queue, output gueue, and 
look-aside buffer. 


Initialize the terminal 
input manager and 
terminal output manager. 
Look-aside 


To buffer 


IKTIIOM 
(MO 1.1.1) 
or 
IKTINX2 


To LOGON 
Initialization 
(IKJEFLA) 


(2) The terminal's ACB is activated 
(opened). If the open fails, 
ABEND OAB is used with reason 
code 0201. 


[3] OPNOST RPL is issued to acquire 
the terminal. 


[4] Terminal control is transferred 
from TCAS to the user's address 
space by placing a work element 
with function code K'21' on 
the terminal handling asynchro- 
nous queue of TCAS (TCASTTQH) , 
posting TCAS, then waiting. 
When TCAS has finished trans- 
ferring control (by issuing 
CLSDST PASS in module 
IKTCAS22), IKTXINIT is posted. 


A GETMAIN macro allocates storage 
for the queues and for the look- 
aside buffer. A BLDCPOOL macro 
divides this storage into equal- 
size queue elements. (The 
BUFPRSIZE value in parmlib member 
TSOKEYOO specifies the size of 
each element.) A GETCELL macro 
allocates one cell for the look- 
aside buffer. The lcook-aside 
buffer is used by the queue 
manager when there ia no more 
storage in the address space to 
build a queue element, and a 
high priority message must be 
sent. 


The I/O managers are initialized 
by calling IBM-supplied routine 

IKTIION or instaliation-written 

routine IKTINX2. 


MO 1.1.1 1/O Manager Initialization Routine (IKTISOM) 


From IKTXINIT 
(MO 1.1) or 
IKTLTERM 

(MO 1.5) 


input 


2) 


Routine 


This routine initializes the termi- 
nal input manager SRB and the termi- 
nal output manager SRB. 


1] The key is changed to 0 (MODESET 
macro) and GETMAINs (subpool 239) 
are issued. If they are unsuc- 
cessful, control returns to the 
caller. 


If the GETMAIN is unsuccessful the 
SRBs are freed (FREEMAIN macro) 
and control returns to the caller. 
Sizes are: 
TIM auto data -1000 
400 
Work area - 3000 
RPL - 112 
FRR ~ 400 
auto data - 320 
240 
744 
856 
112 
~4112 
4148 


bytes 
bytes 
bytes 
bytes 


(TIMRT) 
(others) 


Work area 


RPL - 
Buf fer 
(others) 


The following 
the TOM SRB: 
SABID = 0 
SRBFPLNK = 0 


fields are set in 


SRBASCB 
SRBCPAFF 
SRBPASID 


- Naas {PSASOLD) 

a 

= address space ID 
(ASCBASID) 

4*TCB for SRB 

(TVWATCD) “ 
+IKTOMIDS or +IKTTOMRT 
Or IKTOMLU2 (TSSXTOM) 
*RMTR for PURGEDQ 
(TCASBR14) 


SRBPTCB « 


SRBEP = 
SRBRMTR 


Processing 


Allocite storage for 
the termina) input 
manager SRB and the 
terminal output 
Manager SRB. 


Allocate storage for 
1/0 managers. 


Initialize the terminal 
Qutput manager SRB. 


Initialize the terminal 
input manager SRB. 


Initialize the pointers 
to the ASCII transla- 
tion tables. 


If a logon reconnect was 
done, clear or reset the 
appropriate TVWA fields 
used by the terminal 
input manager and termi- 
nal output manager. 


Schedule the terminal 
input manager. 


a TIM SRA 
TIM/TOM work area 


are 


TIM Autw data 


Work are. 


FRR work 


ared 
TOM auto data area 


Work area 


TVWAATBO 
TVWAATBI 


To IXTXINIT (MO 1.1) of IKTLTERM (MO 1.5) 


pore netting) tener | 


SRBPARM 
SRBSAVE 
SRBPKP 
SRBPRIOR 


*TOM work area 
0 
0 
0 


The following fields are set in 
the TIM SRB: 

SRBID = 0 

SRBFLNK = 0 

SRBASCS = tASCB (PSAAQLD) 
SRECPAFF = 0 

SRBPASID = address space ID 
(ASCBASID) 

*TCB for SRB 

({TVWATCB) 

*IKTIMIDS or tIKTTIMRT 
Or IKXTOMLU2 (TSBXTIM) 
*RMTR for PURGEDQ 
(TCASBR14) 

SRBPARM *TIM work area 

SRBSAVE 0 

SRBPKF 0 

SRBPRIOR 0 


SRBPTCB «= 
SRBEP 


SRBRMTR 


IKTIIOM |LSTMRTN 


IKTI10OM |LSTMRTN 


The appropriate terminal input IKTIIOM 
manager is scheduled (SCHEDULE 

SRB) once for each execution of 

VTIOC: it is always active so 

that it can receive input from 

the terminal. (The terminal out- 

put manager is scheduled when- 

ever it is not already active and 

there is output to be sent to the 
terminal.) 


VTIOC Method of Operation 


MO 1.1.2 OPNDST RPL Asynchronous Exit Routine (IK TRPLXT) 


Input From VTAM API Processing OuLput 
through Dis- 
patcher 


[2] Check the status of 
the OPNDST RPL request. 


@ If OPNDST RPL com- 


TVWAECB 
Sees 


a eS 
pleted successfully, 
post the ECB asso- 
ciated with IKTXINIT. 
TSBXECB If OPNDST RPL did not 


complete successfully, 
post the TSO/VTAM 
cancel ECB. 


To Caller 


This routine checks the status of 
the OPNDST RPL request issued in 
the VTIOC initialization routine 
(IKTXINIT). 
D] The protection key is set to 0 IKTRPLAT 
(MODESET macro) and CHECK RPL 
is issued. 
e After posting (POST macro) IXTRPLXT 
the ECB, the protection key is 
reset (MODESIT macro) to 
specify the problem state. 
e CHECK RPL is reissued as many 
times as specified in TVWARTR. 
Tf the OPNOST RPL did not com- 
Plete successfully when the 
limit is reached, the terminal 
session is canceled. 
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MO 1.2 Extended Logon Routine (IKTXLOG) 


Input From Procecsing Output 
LOGON/ LOGOFF 
Verification 
(IKJEFLE) Register 1 


0) Provice the LOGON 
Scheduling routines 
with the address of 
the logon buffer. 


Logon buffer 
address 


To LOCON/LOGOPF Verification (IKJEFLE) 


This routine sets up the address IKTXLOG 
of the logon command buffer as a 
parameter for the LOGON Scheduling 
routines. 
‘| The address of the logon buffer IKTKLOG 
was placed into TVWAVST by 
IKTXINIT. The logon buffer is in 
subpool 1, key 8 storage. It 
contains the logon command 
entered by a TSO/VTAM terminal 
user. 
This routine is entered for an 
initial logon only, not for a 
re-logon or a logoff. 
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MO 1.3 Logon Reconnect Routine (IK TLOGR) 


Trapt 


One 
element 
on 
TSO/VTAM 
TSB 


chain 


Register 1 


Parameter list 


New TSB 


New TSBX 


CD Meee! 


This routine establishes recon- 
nection of a TSO/VTAM terminal to 
the address space from which it 
was disconnected. It is invoked 
when a logon command specifies a 
Reconnect operand 


The local and CMS locks are 
obtained, and the TSB chain 
searched for a TSB with the 
reconnect bit on (TSBXWREC) and 
with a user ID and password that 
match those of the user request- 
ing reconnection (pointed to by 
registegc.1). 


is 


Unaware that RECONNECT was 
Specified, another LOGON routine 
created a new TSB (and TSBX). 
IKTLOGR now transfers the 
following TSB and TSBX values 
from the new TSB and TSBX to the 
existing ones: terminal symbolic 
name (TSBXSYM), ASCII flag 
(TSB3270, TSBOSPLY), terminal 
characteristics (TSBTRMID), 

and the Bind (TSBXBIND). Later, 
an RTM routine will free the 
unneeded new TBS and TSBX. 


[+] 


The application ID of the old 
terminal is given to the new 
one (CLSDST PASS macro) and the 
old address space is posted. 


Return codes: 
O Successful) reconnection 
4 Invalid password 
@ Invalid user ID 
Cc Unsuccessful reconnection 
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From 
Parse/Scan 
Interface 
(IK.JEFLEA) 


IKTLOGR 


IKTLOGR 


IKTLOGR 


Processing Output 
Find the TSB and TSBX 
belonging to the old 
session. 
(2] Insert values into 01d TSB 
the old TSB and TSBX. a 
[3] Give terminal control 
to the old address Old TSBX 


space. 


[4] If CLSOST PASG& fails, an 
error message is placed 
on the cutput queue. 


IKTOMOUT 


To Parse/Scean Interface (IKJEPLEA) 


[routine] aber | nee | 


MO 1.4 Extended Logoff Routine (IKTLOGF F) 


Input Te (dial pouat. 
from LOGON 

Seheduling 

(UKJEFI.A) 


See ea 2) If the terminal output ‘ 
manager has not yet 
exited, ensure that it TSB 


does not attempt. any 
further processing. Hac switch = 1 
TSBCANC switch = } 


a Sree 
. TVWA 

Call IKTTOMJR to send 
a null RU to the f [ee SS a ee 
terminal. 

To 

IKTTOMJR 

(MO 3.2.1 


[a] Disconnect the terminal 
from TSC. 


Close the terminal 
user's ACB. 


To LOGON Scheduling (IKJEFLB) 


This routine disconnects the 
us:r's terminal from TSO and 
closes the user's ACB. 


2) The local lock is obtained, the 
TSB switches are set, TVWALTE 
is turned on if the TOM is 
scheduled (TVWATIS switch = 1), 
and the local lock is released. 


The CLSDST macro disconnects the 
terminal from TSO. 


[=) SVC 20 is issued to close the 
ACB. If the close is unsuccess- 
ful, abend OAB is issued (ABEND 
macro) and reason code 203 (hex) 
is placed into register 15. 
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MO 1.5 (Part 1 of 2) LOSTERM Exit Routine (IKTLTERM) 


input 


Frocess ing 


Register 1 


flea 


Pugh eerte ge outta 


From VTAM AI 
Through 
Vaspataoher 


Poeopminadl  s ACW 


cement oi ae cana + a 


Terminal's CID 


Entry «code 


Jut out 


[insure that the LOSTIRM 
cntry code is valid. Tf 
not valid, return. 


To 
VTAM 


Check for internal 
vhase. If issued, 
return to VTAM. 


| 
| 
| 
Raa [2] Process s VTAM USS 
| | Unconditional logoff 

request (LOGOFF TYPE 
| (UNCOND)). 
| To 
| or IKJEFLF 
cialis Process a VTAM USS 
| conditional logoff 
| request (LOGOFF TYPE 

(COND)). 
| To 
IKTTOMJR 
(MO 3.2.1) 
| To 
TKTOMIN 

Dump codes ee eae SA (ten 


Reta 
11 a 


code 


Space in a reconnect state. 
is detected, examine dump 


macro. 
the following scecurs- 


an the user address 
transmission problem 


for the assuing SDUMP 
Wait until onc of 


This routine processes VTAM USS 
logoff requests, and handles certain 
VTAM transmission errors for TSO/ 


A request to retain the user 
address space in a reconnect 


VTAM time sharing. 


Tt. is scheduled as 


arn ISB by VTAM, 


The LOSTERM entry codes are 
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listed in VIAM Macro Language 
Reference, GC27-6995. If code 16, 
28, or an unlisted code is 
received, message IKT103I is 
issued and control returns to 
VTAM. 

An unconditional logoff request IKTLTERM|LOGPUNCH 
is indicated by entry code 20. 

The local lock is released and 

CLSDST RPL is issued to disccon- 

nect the terminal from TSO. (If 

the CLSOST macro is unsuccessful, 

ABEND OAB with reason code 0105 

is issued to indicate a VTAM 

resource availability problem.) 

The local and CMS locks are 

obtained, and the system- 

initiated cancel (SIC) routine 

IKJEFLF is branch-entered to 

cancel the user address space. 


A conditional logoff request is 
indicated by entry code 32. 
IKTTOMJIR is called to send a 


null RU to the terminal. Then 
the queue manager is asked to 
put the logoff command on the 
input queue. Parameters passed 
in IPARMS are: 

IPREQ Code 1: Add element to 
bottom of queue 
Terminal type 

Length of logon 
command 

Message available 
indication 


IPTRMTYP - 
IPBFSZ 


IPAVBL 


gtate is indicated by entry codes 
O, 1, 12, 24, 36, 40. The local lock 
is’ released and CLSDST RPL is 
issued to disconnect the terminal 
from TSO. (If the CLSDST macro is 
unsuccessful, ABEND OAB with 
reason code 0105 is issued to 
indicate a VTAM resource avail- 
ability problem.) The local lock 
ia released and a reconnect 
environment is established, if a 
time interval is specified 
(RECONLIM value in parmlib member 
TSOKEY00), by starting the timer 
(STIMER macro). (If 4 reconnect 
environment is not established, 
SIC routine IKJEFLF is branch- 
entered to cancel the user address 
space.) A WAIT macro is issued to 
wait for the timer to expire, a 
CANCEL command to be issued, or 
reconnect to be attempted. 


@ If the timer expires, SIC 
routine IKJEFLF is branch- 
entered to cancel the user 
address space. 


If a CANCEL command is issued, 
control returns to VTAM to 
allow the cancellation to 
proceed. 


If reconnection is attempted by 
the terminal user, reestablish 
the terminal session by doing 
the following: 


MO 1.5 (Part 2 of 2) LOSTERM Exit Routine (IKTLTERM) 


Input Processing ; Output 


@ The reconnect timer 
expires; cancel the 
user address space. 


To 
IKJEFLF 
. A CANCEL command is 
issued; allow the 
cancellation to 
proceed. 
To 
VTAM 
Reconnection is 
attempted by the 
user; reestablish 
the terminal 
session. 
To 
IKTQMOUT 
(MO 4.2) 
To 
IKTIIOM 
(MO 1.1.1) 
or 
IKTINX2 
To Caller 


(a) Connect the terminal to TSO 
(OPNDST RPL); if unsuccess- 
ful, issue ABEND CAB with 
reason code 0105. 


Reguest the output queve 
manager to restore the out- 
put queue to its condition 
prior to the transmission 
problem (line drop). The 
parameter passed in OPARMS 
is OPREQ (reset request, 
code 7). 


Request the output queue 
manager to insert the Logon 
reconnect command on top of 
the cutput queue. The param 
eters passed in OPARMS are 
OPREQ (code 8 - add ele- 


ment to top of queue) and 
OPBFS2 (length of 
command) . 


Reinitialize the terminal 
input manayer and terminal 
output manager by calling 
IBM-supplied routine 
IXTIIOM or installation- 
written routine IKTINX2. 


Schedule the appropriate 
terminal output manager to 
send a message to the term - 
nal indicating successful 
reconnection (IKTOQ300!). 
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MO 1.6 TCAS Termination Routine (IKTAY81) 


Input From IEDAY&S Processing 


Lf any user addresa 
spaces are owned by 
TCAS, post their ECBs. 


Free each work elament 
on the TCAS terminal 
handling asynchronous 
queue. = 


[3] Free the TIM/TOM list. 


TIM/TOM list 


[4] Free the TCAST. 


This routine handles TCAS termination. 


If TCAS terminates before it 

could transfer ownership of one 
Or more terminals to user address 
Spaces, the ECB of each unowned 
address space is posted, each 
work element on the TCAS terminal 
handling asynchronous queue is 
freed, and RTM2 receives control. 


FREEMAIN is issued to free each IKTAY81] 
queue element. 


FREEMAIN is issued to free the IKTAYS] 
TIM/TOM IYist, and the pointer in : 
the TCAST is cleared. (The TIM/ 

TOM list contains the addresses 

of the four TIM/TOM routines.) 


FREEMAIN is issued to free the IKTAYS81/FRTTCAST 


TCAST, and the pointer in the 
CVT is cleared. 
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To 
RTM2 


To RTM2 


Output 


MO 1.7 Terminal User Address Space Termination Routine (IKTAY82) 


From IEDAYS 


Input Processing Output 


2) 


2) 


(=] 


TIM/TOM 
list 


Unchain the terminal's 
TSB from the TSO/VTAM 
TSD chain. 


TCAST 


TCASTTQH 


Request TCAS to rs: 
release the terminal Work 
if it is not owned by clement 


the terminating 
address space. = 


Resolve ASID TPUT ’ 
requests to the 

terminating address 

space. 


Clean up ASID TPUT 
requests from the 
terminating address 
space. 


Free the TSB and TSBX. 


If TCAS has terminated 
abnormally and no more 
terminal users are 
active, free the TCAST, 
the TIM/TOM list, and 
the TCAS terminal 
handling asynchronous 
queue. 


To RTM2 


ots rutting | ates | rer | jacten [routine] tanet | tet 


This routine handles TSO/VTAM termi- IKTAY82 
nal user address space termination. 


fa] The forward and backward chain IKTAYS2 
pointers are manipulated to 
unchain the terminal's TSB and 
TSBX. 


[2] the terminal will not be owned by 
the terminating address space if 
‘an error occurred before TCAS 
could transfer control of the 
terminal to the address space. 


terminating TSO/VTAM address 
Space. When such a TSB is found, 
its ASID TPUT switches are 
cleared, IEDAYTPQ is called to 
inform TSO/TCAM not to expect 
any more ASID output, and tasks 
associated with this TSB are 
marked dispatchable (STATUS 
Macro routine}. 

The TSO/VTAM TSB chain is 
searched for TSBs that indicate 
an ASID TPUT request to a TSO/ 
VTAM address space from the 


REQREL places a work element with REQREL terminating TSO/VTAM address 


function code X'22' on the termi- 
nal handling asynchronous queue 
of TCAS and posts TCAS. 


If the source address space has 
not relinquished control of the 
TVCS and cross-memory TPUT SRB, 
TVCSRCRC is set to indicate that 
the target (terminating address 
space) relinquishes control of 
the TVCS and crose-memory TPUT 
SRB, and the source is informed 
that the target has terminated by 
means of IKTAY8 posting (POST 
Macro routine) the TVCS ECB with 
code X'l4' (ASID TPUT complete). 
If the source address space has 
relinquished control of the TVCS 
and crogss-memory TPUT SRB, the 
SRB is freed (FPREEMAIN macro) 
and the TVCS is freed (FREEMAIN 
macro). Note that PURGEDO is 
issued to ensure that the SRB is 
dequeved before it is freed: if 
it has been dispatched it is 
allowed to execute. 


space. When such TSB is found, if 
the target address space is no 
longer active, outstanding posts 
are allowed to complete (SPOST 
macro), the cross-memory TPUT SRB 
is freed, and the TVCS is freed. 
When such a TSB is found and the 
target address space is still 
active, TVCSRCRC is set to indi- 
cate that the source address 

space is no longer active (leaving 
the target with the responsibility 
of freeing the cross-memory TPUT 
SRB and the TVCS). 


The tarminal input manager SRB 
and the terminal output manager 
SRB are freed, and the logon 
buffer is freed. 


FREEMAIN is issued to free the FREETSB 
TSB and the TSBX. The TSB pointer 
in the ‘ASCB is cleared. 


FREEMAIN is issued to free the FRITCAST 
TCAST, the TIM/TOM list, and each PRITLIST 
work element. The TCAST pointer FRWESTD 


The TSO/TCAM TSB chain is IKTAY82 |SRCHTCAM in the CVT is cleared, and the 


searched for TSBs that indicate 


an ASID TPUT request to a TSO/ 
TCAM address space from the 


TIM/TOM list pointer in the TCAST 
is, cleared. 
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MO 1.8 TSO/VTAM QTIP 29 Equivalent (IKTAY83) 


Thput Processint aes eee 


From JOCUAYH 


—---— [1] Clean up MSID TPLT 
requests from a termi- 

nating TSO/TCAM address 

space. 


To TEDAYS 


Se ER A md ii =o Raa 


“otcs pee zee moe 


ee ee 


This routine cleans up ASID TPLT IKTAYS 3 
requests to a TSO/VTAM address space 
from a terminating TSO/TCAM address 
space. 


The TSO/VTAM TSB chain is IKTAY22 |SRCHVTAM 
searched for TSBs that indicate 

an ASID TPUT request to a 7S0,/ 
VTAM address space from a termi- 
nating TSO/TCAM address space. 
When a TSB is found, if the target 
address space is no longer active, 
outstanding posts are allowed to 
complete. (SPOST macro), the cross- 
memory TPUT SRB 1s freed, and the 
TVCS is freed. When a TSB is found 
and the target address space is 
still active, TVCSRCRC is set to 
indicate that the source address 
space is no longer active. 


FRECSRA 
FREETVCS 
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MO 2.0 Overview of TGET/TPUT Routines 


Input Processing Output 


Register 1 

leftmost bit:} | TSBVTAM bit: 
0 = TPUT 0 = TSO/TCAM 
1 = TGET 1 = TSO/VTAM 


(2] Process a TGET requeat: 


To 


© TSO/TCAM reco009c 


or 

To 

@ TSO/VTAM IKTVTGET 
(MO 2.)) 
Process a TPUT without 

ASID request: 


To 


© TSO/TCAM 1GG09301 


or 
To 

® TSO/VTAM IKTVTPUT 
(MO 2.2) 
Process a TPUT with 

ASID request: 


To 
@ TSO/TCAM 1GG09302 
or 
To 
@ TSO/VTAM IKTASTPT 
{MO 2.3) 


One 
element 


searched to find the target of the 
TPUT ASIO. The search looks for a 
match for the address space ID 
(ASCBASID) or the user ID (CHKEY). 
When found, the appropriate ESTAE 
routine is set up (ESTAE macro} 
and the TPUT routine is called. 

If a match is not found, code 14 
(hex) is returned in register 15. 


terminal. They are used by the TSO 
command processors, the TSO terminal 
monitor program, the TSO I/O service 
routines, and user-written command 
processors. They receive control 
after SVC 93, a TGET macro instruc- 
tion, or a TPUT macro instruction is 
issued. (Note that specifying TGET 
or TPUT invokes SVC 93.) 


The function described in this 
diagram is contained in object 
module IGCO009C, which is the 
first TGET/TPUT module to receive 
control in load module IGCOOOSC, 
It is entered from the SVC second 
level interrupt handler, and it 
transfers control to the appropri- 
ate TIOC and VTIOC TGET or TPUT 
routine. IGCO0009C is described 
here from VTIOC's viewpoint; it is 
described from TIOC's viewpoint in 
OS/VS2 TCAM Logic, SY30-2040. 


[2] If an address space ID (Reg. 0) or 
user ID (Regs. 1, 15) was not 
specified, or if the specified 
address space ID (Reg. 0) matches 
the active address space ID 
(ASCBASID), or if the specified 
user ID (Reg. 15) matches the 
active user ID (CHKEY), TPUT with- 
out ASTO was issued. 


rete tine | tos | net 


The TGET and TPUT routines handle the (3) The appropriate TSB chain is | 


movement of data between TSO and a 
VTIOC Method of Operation 19 


MO 2.1 (Part 1 of 2) TGET Routine (IKTVTGET) 


Input 
From IGCO0009C 


Parameter 


. jirauraoR | 
pe | 


ne eae Sy 
Input gueve element 


eee ee eee ee 


This routine handles TSO/VTAM TGET 
requests. It takes data from the 
input queue, edits it, and places it 
in the TGET requester’s buffer. 


The local lock is held on entry to 
IKTVTGET. 


If the terminal session is no 
longer active or if ATTN was 
pressed, control returns immedi- 
ately to IGC0009C. Otherwise, the 
- queue manager is called to get an 
element from the input queue. The. 
following parameter is passed to 
the queve manager in IPARMS: 


IPREQ - Code 2: 
next element. 


Obtain address of 


If the gqueve manager 18 unable to 
obtain the data (IPRC # 0), 
achedule the terminal output 
manager to unlock a 3270 keyboard, 
suspend the TGET requester (by 
calling the STATUS macro routine) 
until data is available or ATTN 

is pressed if TGET WAIT was speci- 
fied, inform the SRM of the wait 
(SY¥YSEVENT macro), and obtain the 
local lock upon being redis- 
patched. 3 
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J sctes routine] tates | net | 


IKTVTGET 
IKTVTGET 


Processing 


Ask the queve manager 
for input. 


Edit the input data and 
move it to the TGET 
requester's buffer. 


Ensure that all the 
data has been edited 
and moved. 


uses one 
routines 


IKTGETXT 


IKTIDSK4 


EDIT3270 


IKTRTX4 


EDIT3767 


Output 


To 
IKTQMIN 
{MO 4.1) 


To 
IKTOMIN 
{MO 4.1) 


To caller 
(SVC exit) 


for editing: 


nals other than 3270, 
3767, 3770 
Can be written by an 


installation to replace 


EDIT3270 
Edits and moves data 
from 3270 terminals 
Can be written by an 
installation to 
replace EDIT3767 
Edits and moves data 
from 3767 and 3770 
terminals 


The adit routines perform device 
independent editing. They remove 
invalid characters, remove 3270 
control characters, pad with 
blanks if the EDIT operand was 
specified, and move the data 
from the input queue to the TGET 
requester's buffer. 


Edits data from termi- 


Register 9 


TGET requester's buffer 


wots | outine | tater | ee | 


(2) VERIFY determines if the TGET 
requester's buffer address is in 
the TGET requester’s key. IXTVTGET 

or more of the following 


VERIFY 


MO 2.1 (Part 2 of 2) TGET Routine (IKTVTGET) 


Input Processing Output 


The queve manager is called to 
unchain the edited element from 
the input queue and to free 
associated storage. The following 
parameter ia passed in IPARMS: 


IPREQ - Code 3; Remove element 
from queue. 

SRM is informed <(SYSEVENT macro) 
of TGET completion. However, if 
the TGET requester's buffer is 
smaller than input line size, 
call the queve manager to update 
the pointer to the first un- 
moved character. The following 
parameter is passed in IPARMS: 


IPREQ - Code 4: Update element. 
Return codes (in hex); 


Successful 

No input available and TPUT 
NOWAIT was specified 

ATTN key was pressed; message 
was not received 

TGET requester's buffer too 
small to hold input line 
Terminal could not be reached 
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MO 2.2 TPUT without ASID Routine (IKTVTPUT) 


Injgeat From IGC0009C lrucessing 

XSA 

XSABFRAD ~” 
Ensure that the termi- 

yo GEESE nal session was not 

canceled and the ATTN 
key not pressed. 

TPUT requester's buffer 


OE Edit the data. 


Request that the queve 
manager add the TPUT 
data to the output 
queve. 


Schedule the terminal 

output manager to send 
the data to the termi- 
nal. 


If TPUT HOLD was speci- 
fied, suspend the task 
until the data arrives 
at the terminal or 
until the ATYN key is 
pressed. 


To caller (SVC exit) 


This routine handles TSO/VTAM TPUT 
without ASID requests. It takes data 
{rom the TPUT requester’s buffer, 
edits it, and places it on the output 
queue. 


vote mutine | aber | nee | 


(s] The SRM is notified (SYSEVENT 
macro) that IKTVTPUT is suspended. 
When the data arrives at the 

terminal, the SRM is notified 

(SYSEVENT macro) that the TPUT is 

complete. 


tj TERMSTAT checks the terminal's 
status and WIFOWAIT determines if 
another task owns the TSB. If 
another task does own the TSB 

{is processing a TPUT), WAITCHK 
suspends IKTVTPUT (STATUS macro 
routine} until the TSB is avail- 
able. 


Any tasks waiting on IKTVTPUT are 
marked dispatchable (STATUS macro 
routine), and the local lock is 

released. 


WAITCHK 


Return codes (in hex): 


Successful 

4 No output buffer available 
and TPUT NOWAIT specified 

8 ATTN key was pressed; 
message was not sent 

14 Terminal could not be 

reached. 


Device independent editing is per- |IKTVTPUT| DATAEDIT 
formed. It consists of removing 
trailing blanks. 


IKTVTPUT | TRYTOQUE 


The following parameters are 
passed to the queue manager: 


OPBFSZ <= Size of TPUT data 
OPFLAGS - Output options from 
XSAOPTNS 
OPREQ - Code 1: Add element to 
bettom: or, if BREAKIN 
specified, 
Code 8: Add element to 
top. 


If the deta cannot be added to the 
queuc because high buffer thresh- 
old is reached, IKTVTPUT is sus~ 
pended (STATUS macro routine) 
unless TPUT NOWAIT was specified, 
until the queve manager is able 

to add the data. 


WAITCHK 


IKTVTPUT| SCHEDTOM 


The appropriate terminal output 
manager is scheduled (SCHEDULE 
SRB) if not already scheduled 

{TVWATIS) and if available to be 
scheduled (TVWATAS). 
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MO 2.3 Calling Address Space TPUT with ASID Routine (IKTASTPT) 


Input 


From IGC0009C 


TSBITOFF switch ee ee 
eee te ee 


XSA 
XSABF RAD 


TPUT requester's buffer 


This routine handles TSO/VTAM TPUT 
with ASID requests for the calling 
address space. It takes data from the 
TPUT requester’s buffer, edits it, 


by IXTXMTPT. 


The local lock is held on entry to 
IKTASTPT. 


[1] TERMSTAT determines if TSO/VTAM 
is still running (CVTTCASP), if 
the target terminal is still in 
session (ASVTAVAL, ASCBTSE, 
XSAASID), and if the target termi-~ 
nal had ite6 session canceled. 
{TSBANC), was disconnected 
(TSBDISC), or way not completely 
initialized (TSBXACTV). Register 
15 is set to hex 14 if any of 
these conditions is negative. 


Whenever the TSB of the target 
terminal is referred to, the CMS 
lock is held to prevent the target 
address space from freeing the 

TSS should the target terminate. 


[2] If the target terminal specified 
no inter-terminal communication, 
(TSBITOFF), the TPUT is not 
honored unless the calling termi- 
nal is appropriately authorized 
(TESTAUTH macro) and specified 
the HIGHP operand. 


[3] The ENQ macro is issued to engue 
on the target terminal's address 
space 10. The ENQ qname is 
SYSZIGGI; the rname is the ID of 
the target address space. 


IKTASTPT 
IKTASTPT| TERMSTAT 


and places it in the TVCS for handling 


Processing Vut put 


Ensure that the target 
terminal is still 
active. 


Ensure that the target 
terminal is allowing 
inter-terminal 
communication. 


Prevent simultaneous XSA 

TPUTs to the target . 

terminal. sapasecseheaeld 
a 


Edit the data if the 
EDIT operand was 
specified. 


TPUT requester's buffer 


wn 


Obtain and initialize Re 


an SRB and TVCS. 


Schedule IKTXMTPT to 
put the TPUT data on 
the output queue in 
the target address 

space. 


HG BY 


lit 


Free the SRB and 
TVvCs. 


To caller 
(SVC exit) 


[4] DATAEDIT scans the calling termi- |IKTASTPT|DATAEDIT 
nal‘s data and performs device 
independent editing, that is, it 
removes trailing blanks. 


[s] The SALLOC locks are obtained 
before storage is allocated 
{GETMAIN macros) in the CSA for 
an SRB (for scheduling IKTXMTPT) , 
and TVCS. The TVCS holds the data 
until IKTXMTPT in the target 
address space can move :t to the 
output queue. TERMSTAT ensures 
that the target terminal did not 
go down while the CMS lock was 
released. INITTVCS initializes 
the TVCS, VERIFY ensures that the 
caller‘’s area is in the caller's 
key. and INITSRB initializes the 

SRB. 


IKTASTPT 


TERMSTAT 


INITTVCS 
VERIFY 


INITSRB 


IKTXMTPT is scheduled (SCHEDULE 
SRB) in the target address space. 
IKTASTPT waits (WAIT macro} until 
posted (POST macro) by IKTXMTPT. 
If IKTXMTPT abends, IKTASTPT 
reschedules it once. 


TERMSTAT ensures that the target |IKTASTPT|TERMSTAT 
terminal did not go down while 


the CMS lock was released. 


Return codes (in hex): 


Successful 

4 Buffer not available or ENQ 
resources not available, and 
TPUT NOWAIT specified 

c PROFILE NOINTERCOM specified 

by terminal operator 

Terminal could not be reached 
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MO 2.3.1 Target Address Space TPUT with ASID Routine (IKTXMTPT) 


From IKTASTPT (MO 2.3) through Dispatcher 
Input Processing Nutput 


(1) Call IKTTOMIR to send 
a null RU to the 
terminal To 
TKTTOMJR 
(Mo 3.2.1) 


(z] Request that the queve 
manager add an element 
to the output queue. To Parameters 


TKTQMOUT OPBUFADR 
(MO 4.2) 


. 


TYCS 


TYCSDATA : [3] Mcve the TPUT data into Output queue element 
the output queue 
clement. 


[a] Schedule the terminal 
output manager to send 
the data to the termi- 
nal. 


[5] Post IKTASTPT in the 
calling terminal's 
address space. 


From R/TM To Caller 


[6] Post IKTASTPT in the 
calling terminal's 
address space if 
IKTXMTPT abnormal ly 
terminated. 


To R/TM 


This routine handles TSO/VTAM TPUT IKTXMTPT 
with ASID requests for the target 

address space. It takes data from the 

TVCS and places it on the output 

queue. It is scheduled by IKTASTPT 

as an SRD. 


[2] Set up FRR IKTXMFRR by issuing 
the SETFRR macro, obtain the 
loval lock, ensure that TSO/VTAM 
and the terminal are still active, 
and pass the following parameters 
to the queue manager in OPARMS: 


OPREQ ~ Code 8: Add element to 
top 

OPBFSZ Size of TPUT data 

OPOPTNS Output options from 
TVCSOPTN 

OPASID TPUT ASID specified 


If the queue manager is unsuccess-— |IKTXMTPT 
ful (OPRC # 0), TSBTJBF is set so 

that the queue manager reschedules 

IKTXMTPT when buffer space is 

available. However, if NOWAIT was 

Specified (TVCSNOWT), IKTASTPT is 

posted with an indication that 

the TPUT could not be done. (POST 

code = 4.) 


[+] The appropriate terminal] output IKTXMTPT 
Manager is scheduled (SCHEDULE 
SRB) if not already scheduled 
(TVWATIS) and if available for 
echeduling (TVWATAS). 


[5] IKTASTPT in the calling terminal's [IKTXMTPT | 
address space is posted and SRM is 
notified (SYSEVENT macro). 


[6] The calling terminal's address IKTXMFRR 
space is posted, indicating 
that the FRR was entered. 
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MO 2.4 ESTAE Routine for SVC 93 (IKT93EST) 
From R/TH 


Input Processing Output 


SDWA 


SDWAPCHK switch |_ jj — — — — I) Y€ the program check 

occurred during a data SDWA 
move, change the systen 

completion code to 15D. @ACHPC 


XSA 
XSADMOVE switch 


Clean up the TSB 
associated with a TPUT 
request. 


4 
ua 
| 


If an address space ID 
was enqueued on in 
IXTASTPT, dequeue it. 


To R/TM 


This routine is entered when one of 
the VTIOC TGET/TPUT routines 
(IXTVTGET, IKTVTPUT, or IKTASTPT) 
abends, or, through percolation, when 
the queue manager abends. It changes 
the abend code, cleans up the TSB, 

and dequeves the target address space. 

[1] If the buffer address specified 
on the TGET or TPUT macro is not 
in the caller's key, the program 
check that occurs (usually 0C4) is 
changed to system completion code 
18D. The TGET or TPUT is not 
retried; recovery is left to the 
next higher ESTAE routine. 

There is no cleanup required with 
& TGET requeat. For a TPUT request 
tasks waiting for the TPUT 
proceasing to complete are dis- 
patched {STATUS macro routine), 
and TSB fields TSBOWIP and 
TSBCTCB are cleared. ff the TPUT 
request specified ASID, and the 
target address space relinquished 
control or IKTXMTPT was not 
scheduled, clear TSB fields 
TSBWIJID and TSBWICB and TSBX 
field TSBXCSAP if the target 
terminal is still connected, and 
free (FREEMAIN macro routine) the 
SRB (used for IKTXMTPT) and the 
TVCS after ensuring that the post 
from the target address space has 
completed. 

J The enqueuve in IKTASTPT prevents 
simultaneous TPUTs to the target 
terminal. The DEQ gname is 
SYSZIGGI; the rname is the ID of 
the target address space. 
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MO 3.1 (Part 1 of 2} 3270 LUO Terminal Input Manager (IK TIMIDS) 


Input 


Notes 


TUWA 


TVWAPGN switchfFe-- -—— 


From IKTIIOM 


(MO 1. 


1-1) 


through 


Dispatcher 


VTAM buffer 


Fe eee Hint 


This routine obtains IBM 3270 termi- 
nal input from a VTAM buffer and‘ 
places it on the input queue for pro- 
cessing by the 1GET routine. 


26 


a 


The RPL for the RECETVE macru 
1S initialized at first entry 
to IKTIMIDS. Upon initial en- 
try and after each RECEIVE is 
completed, issue SETFRR to 
establish recovery function. 
Up to two RECEIVE macros are 
issued to obtain all the input 
from the VTAM buffer. If the 
RECEIVE is unsuccessful, retry 
is attempted. If retry is un- 
successful three times, ABEND 
OAB is issued. If the LOSTERM 
exit routine was entered, 
[IKTIMIDS exits to IKTEXIT. 


After the input is processed, 
RECEIVE :s issued for more in- 
put. In this way a RECEIVE re- 
quest is always outstanding. 


Tf the yvser is paging, only an {INTIMIDS |DATARTN 


attention interruption is 
recognized. The line count is 
reset to one (TVWALNCT), the 
indicator is turned on to for- 
mat the screen (TVWAFMSC) and 
the terminal output manager is 
scheduied if requcsted. 


IKTIMIDS 


IKTIMIDS |PRIMPROC 


IXTEXIT 


Procesusine 


Obtain input by issuing a 
RECEIVE macro. 


(a) Tf the user is screen 
raging, do not process 
the input (unless it 
13 an attention key 
interruption). 

(b) If PAl and CLEAR keys 

are passed to the 

command processor, 

bypass steps 3 and 4. 


lf the input is an atten- 
tion interruption, process 
it: 


(a) Call an installation- 
written attention 
routine if there is 
one. 


or 


Call IKTATTN which 
asks the queue 
manager to clear the 
input and output 
queues. 


(b) 


If the input indicates 
that the CLEAR key was 
pressed, schedule the 
terminal output manager 
to unlock the keyword. 


called, 


INITFRR 


REC 


VTAME.RR 
EXITERR 


FINPROC 


ie 


CHTOM 


2 es 


en ee me en 


If the user entered an attention | IKTIMIDS| DATARTN 
interruption, an installation- 
written attention routine is 

if there is one, and the 
IBM-supplied routine is bypassed. 


(b) Code 5 is passed in IPARMS. 
IKTATTN is called to remove 
all elemantas from the input 
gueue. Code 5 is passed in 
OPARMS to ask the output 
queve manager to remove 

all elements from the 
output gqueve. 


If the user preased 
key, the line count 
one (TVWALNCT), the 
turned on to format 
(TVWAFMSC), and the 
output manager is scheduled to 
unlock the keyword. 


Output 
RPL 
ee 
TIM buffer (1500 bytes) 
See ea 


reer 


To 
IKTIDSX3 


ee eee eee 


I 
| 
| 
{ 
L 


IKTIMIDS| ATTN 


the CLEAR DATARTN 
is reset to 
indicator ia 
the screen 


terminal 


IKTIMIDS 


MO 3.1 (Part 2 of 2) 3270 LUO Terminal Input Manager (IK TIMIDS) 


Input Processing Gutput 


Tf the input is data, 
process it. 


If there ia an error, 
handle it. 


q 
| 
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Data is processed and the loop 
resumes processing at step l. 

Up to three retries are attempted, 
then IKTIMIDS either calls 
IXTEXIT or abnormally terminates. 


M.O 3.2 3270 LUO Termina! Output Manager (1 KTOMIDS) 


From IKTLTERM 
Input {moO 1.5), Processing Output 
IKTVTGET (MO 
2.1), 
IKTVTPUT (MO 
2.2), IXTXMTPT 
{MO 2.3.1), 
IKTIMIDS (MO 
3.1), IKTO9401 
(MO 5.1), 
IKTO9409 (40 
5.4), TKT0940C 
(MO 5.6), or 
IKTOS406 (MO 
5.8) through 
Dispatcher 


SSS Establish recovery func- 
tion. Call IKT32700 to 
see if there is data; 
if there is, IKT32700 To 
builds an RU. > =KT32700 


(MO 3.10) 


TOM work area 


Send the RU to the term- 
nal. Reestablish recovery 
function. 


Delete from the output 
queue messayes that have 
reached the terminal. SI ODULESr 


Return to step 1 to 
process more output. IKTQMOUT 
(MO 4,2) 


To Caller 


routine | aber | net jwotee [routine | nator | at | 


1KT32700] INITFRR 


{2} A SEND macro is issued. If an 
error occurs attempting to send, 
the macro may be reissued three 
times before termination is 
required. 


IKTOMIDS]SENDRU 


Code 3 is passed in OPARMS to 
the output queue manager if 
positive function management end 
(FME) was received. 


[KTOMIDS| ERREXIT 


[4] If the terminal input manager 
is no longet’ active, permanent 
cleanup is required: the TOM 
work area and SRB are freed 
(FREEMAIN macro) and control 
returns to the dispatcher. Other- 
wise, processing returns to 

step 1 until there are no more 

RUs to send. 
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MO 3.2.1 Terminal Output Manager Null RU Routine (IK TTOMJR) 


Input Processing Output 
From IKTLOGFF 
(MO 1,4), 
IKTLTERM (MO 
1.5), o£ 
IKTXMTPT (MO 
2.3.1) 


TSB 


cBIWAI® awiteh _ “KS [1] re there is an input wait in 
| progress, and the terminal 
Pierre ase output manager is active, 

| 

| 

ul 


and no data is on the output 
TVWA queve or the keyboard is 
locked, and paging is not 
TVWATIR switch occurring, build one of the 
TVWADOOG switch = following null RUs; 
TVWAKBDL switch 
TVWAPGN switch — (a) For a 3270, build a null 
write: xX'FIWO" (EBCDIC) 


Or X'3120° (ASCII). 


rm 
| 
| ~y 
ta For a 3767/3770, build a iz 
space-backspace combin- 
eeeeicar =, ation: x'4016' (EBCDIC) 
or X'2008' (ASCII). 


VTAM buffer 
[2] sena the RU to the terminal. 


tc 


To Caller 


This routine sends (SEND macro) a null |IKTTOMJR 
RU when one of the terminal output 
managers (IKTOMIDS or IKTTOMRT) cannot 
send an RU because it is suspended. 
This happens after a TSO/VTAM user has 
been canceled via the system-initiated 
cancellation routine, a conditional 
logoff has occurred, or a cross-memory 
TPUT has been sent to a 3767 or 3770 
terminal. Sending a null RU causes 
VTAM to be dispatched, thus notifying 
VTAM that the user's address space is 
swapped in again ao that the terminal 
output manager can be dispatched. 
t) A GETMAIN macro ig issued to IKTTOMJR 
obtain storage for the null RU. 
The storage ia freed (FREEMAIN 
macro) after the RU is sent. 
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MO 3.3 (Part 1 of 2) 3767/3770 Terminal Input Manager (IKTTIMRT) 


input From IKTITOM 
(490 1.1.1) 
through 
Dispatcher 


VTAM buffer 


3770 terminal input from a VTAM buffer 
and places it on the input queue for 
processing by the TGET routine. 


initialized at first entry to 
IKTTIMRT. The recovery function 
is established and RECEIVE 1s 18- 
sued to obtain input. The recov- 
ery function is reestablished. If 
the RECEIVE 18 successful, the 
input is processed. If the RECEIVE 
is unsuccessful, retry is attemp- 
ted. If unsuccessful three times, 
ABEND OAB if issved. If the LOS- 
TERM exit routine was entered, 
IKTTIMRT exits. 


After the input is processed, 

RECEIVE 1s issued for more input. 
In this way a RECEIVE request is 
always cutstanding. 


4 table is used to convert ig 
it to EBCDIC. If requested 
by the user (TERMINAL com- 
mand), character translation 
1s pertormed,. 


IKTRTX2 may be used to do 
scanning and editing in 

addition to that provided by 
IKTTIMRT. 


Buffered data is scanned for 
Return indicators so that 
the data can be broken up 
into single lines. 
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This routine obtains IBM 3767 and IBM KTTIMRT 


fa} The RPL for the RECEIVE macro is |IKTTIMRT 


Processing Output 


Obtain input by issuing a 
RECEIVE macro. 


If the input is data, 
process it: 


(a) Convert ASCIT data to 
EBCDIC and/or perform 
user-specified char- 

acter translations. 


Call an installation- 
written edit exit 
routine if there is 
one. 


Break buffered data 
into single lines. 


Ask the queue manager 
to add an element to 
the input queue. 


IKTQMIN 
(MO 4.1) 


Move a line of data 
into the queue element. 


Parameters 
[I PBUFADR 


Repeat steps d and e 
until all the lines of 
a buffered group have 
been moved into 

queue elements. 


Input queue element 


If a cancel command was 
received, ask the queve 
manager to remove the 

canceled chain from the 
input queue. 


To 
TRTQMIN 
(MO 4,1) 


j tates | nee | 


PRIMPROC 
INITFRR 


REC 
INITFRR 
VTAMERR 


EXITFRR 
FINPROC 


{d) Code 1 is passed in IPARMS ADDELR 
to ask the queue manager to 
add an element to the bottom 
of the input queue. 
A cancel command is received IKTTIMRT| CANCELR 
when the CANCEL kcy is pressed. 
Code 6 is passed in IPARMS to 
ask the queue manager to remove 
from the queue elements that are 
not marked available for TGET. 


MO 3.3 (Part 2 of 2) 3767/3770 Terminal Input Manager (IKTTIMRT) 


Input Processing Output 


If a Logical Unit Status 
command was received, 
schedule the terminal 
output manager to resend 
output. 


If an attention interrup- 
tion was received, process 
it: 


(a) Call an installation- 
written attention 


routine if there is 
one e 


TKTRTX 3 
or 


Use the IBM-supplied 
attention processor, 
which uses the queve 
manager to clear the 
input and output 
queues, 


To 


IKTOMIN 
(MO 4,1) 


To 
IKTOMOUT 
(MM 4.2) 


and then schedule the 
terminal output 
manager to send the 
attention message (!). 


To Caller 


juste routine] tater | nor | 
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[4] A Logical Unit Status command LUSTAT 
is received when the CANCEL key 
is pressed between chains after 
a negative function management 
end (PME), when buffer conten- 
tion is indicated to the host, 
or when an intervention required 
condition is satisfied, 

If the user entered an 

attention interruption, an 

installation-written attention 
routine is called, i€ there is 
one, and the ISM-supplied 
routine is bypassed. 

(b) Code 5 is passed in IPARMS 
to ask the input queue 
manager to remove all ele- 
ments from the input queue, 
Code 5 is passed in OPARMS 
to ask the output queue 
manager to remove all ele- 
ments from the output queue. 


MO 3.4 (Part 1 of 2) 3767/3770 Terminal Output Manager (IKTTOMRT) 


From IKTLTERM (MO 1.5), IKTVTPUT (MO 2.2), IKTXMTPT (MO 2.3.1), IKTTIMRT (“0 3.3), 
IKTO9401 (MO 5.1L), IKTO9409 (MO 5.4), TKTUSIOC (MO 5.6), or IKTO940E (MO 5.8) 


through Cispatcher 
mout . Processing 


TVWA 
TVWAGERRE cwitch 
TVWAATN 

TVWAAIGN owitch 


— ee ee ee ee eee 


Outpyte 


Buald an RU containing one 
of the following items: 


(a) An attention (!) oc 
attention-iqnored ({T) 


Parameters 


signal. 


OPBUFADR 


Output queve element 


@ Edit message. 


TVWA 


nae 


TVWATRAN swit-h 


TSBX y 


1 
| PSBXASCT cwitch ' -~-~+—--—4d 
sc ates terminal. 


Send the RU to the 


User data 


e Get message. 


An error message. 


To 
TKTQMOUT 
(40 4.2) 


To 
IK TRTXL 


(d) Auto-prompt data. 
Perform user-specified 


and/or EBCNIC-to-ASCU 
] character translation. 


VTAM buffer 


Delete from the output 
queue messages that have 
reached the terminal. 


To 
IKTQMOUT 
(MO 4.2) 


Return to step 1 to 
process more output. 


This routine takes, from the output IKTTOMRT 
queue, output processed by the TPUT 
routine, and sends it to a VTAM buffer 
for transmission to an IBM 3767 or 
3770 terminal. 


The RPL tor the SEND macro is 

initialized at first entry to 
IKTTOMRT. Functional recovery 
is established. 


IKTTOMRT 
INITFRR 


Switches indicate which type of 
RU should be built. 


(a) The SESSIONC macro is issued 
to send the Clear command 
and Start Data Traffic com- 
mand. The character “!" ig 
put into the RU for each 
accepted attention inter- 
ruption. The characters 
"tI" are put into the RU 
when an ignored attention 

interruption is detectad. 


The SESSIONC macro is 
issued to send the Clear 
command and Start Data 
Traffic command. An error 
message is put into the RU, 


Code 2 is passed in OPARMS 
to ask the queue manager to 
obtain the address of the. 
message in the next avail- 
able queue element. 
Installation-written exit 
routine IKTRTXL is called, 
if present. Then normal 
editing may be performed, 
depending on-the return code 
from IKTRTX1, by editing the 
Message according to the 
operand specified on the 


BLOMSGS 


ENITMSG 
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pacts totam | tates | | putes 


To Caller 


TPUT macro (EDIT, ASIS, or 
CONTROL), and placing the 
edited message into the RU. 


Messages from one or more 
elements are put into a 
Single RU. If a queue ele- 
ment contains a cross- 
memory message, a breakin 
message, or 4 control mes- 
sage, the message is the 
only one put into the RU. If 
a queue element contains any 
other kind of message, the 
message is put into the RU 
with messages of the same 
type from other elements, to 
fill the RU. 


If prompting is specified 
and an RU is empty, a line 
number or character-prompt 
character is put into the RU 


If requested (TERMINAL command), 
the edited output data is trans- 
lated by using a user-specified 
translation table. If specified, 
the data is translated from 
EBCDIC to ASCII. 


A SEND macro is issued and the 
RU is sent as first, middle, 
last, or only RU in a chain. 
{Chain length is determined by 
the CHNLEN value in parmlib mem- 
ber TSOKEYOO.) Functional re~ 
covery is reestablished. If the 
RPL indicates that buffer conten 
tion has prohibited the message 
from being sent, a signal 18 
Sent (SEND CONTROL=SIGNAL) to tha 
message through if it 1s an 


routine} taver | net | 


EDITASTS 
CNTRLOP 


BLDMID 


IKTTOMRT] SENDRU 


INITERR 


MO 3.4 (Part 2 of 2) 3767/3770 Terminal Output Manager (1K TTOMRT) 


Input Processing Cutput 


Notes Routine | Label net. Notes Lobel jae | 
‘attention or attention ignored 
indication, an error message, or 
a breakin message. If the RPL CHKRESP 
indicates that the CANCEL key 
was pressed, the chain is can- 
celed. If the RPL indicates an EXITFRF. 
error condition, the RPL is re- 
built and the operation is re- 
tried three times. If the prob- 
lem continues, ABEND 0AB is 
iasued. 
Code 3 is passed in OPARMS. IKTTOMRT |BLDMSGS | 4.2 
If the terminal input manager is |IKTTOMRT |CLEANXIT 
no longer active, permanent 
cleanup is required: the TOM 
work area and SRB are freed 
(PREEMAIN macro) and control 
returns to the dispatcher. Other 
wise, processing returns to step 
1 until there are no more RUs to 
send. 
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IE) 


MO 3.5 (Part 1 of 2) 3270 LU2 Terminal Input Manager (IK TIMLU2) 


, . 
talent 


From IkTIOOM | 
through 
Dispatcher 


LJ 
J 


Reyister 1 


Work area 


ma} o 


eA Oe Ee A me Kot i ae 


7Tnas routine issues the YTAM RECEIVE: 
macro, determines what the input is 
when the RECEIVE is satsified, calis 
the appropriate routine to process the 
input and loops hack to reissue the 
PECEIVE. The RECEIVE may be satisfied 
with PATA, CANCEL, LUSTAT, SIGNAL, 
CLEAK or some kind of error condition. 


Upenm an)taal entery to LETIMLU2 
the asuress of ao work area is 

sterel, the SRWo1s freed, and | 
the recovery funetion is estab- 
lished. 


TETIMLES 


This is the primary restarting 
Point in case of failure due to 


an error condition. The RPL is 
initializea. 
3] The recovery environment is 


reestabiished. If the RECEIVE 
is unsuccessful, retry is 
atcrcempted. if LOSTERM was en- 
countered, IKTIMLU2 exits. If 
the retry is unsuccessful three 
times or if an unrecoverable 
error has occurred, ABEND OAD 
is issued. 


Check the RFI. control f:elds 
fer type of input. 


[s] 


oe 


(a) Up to two RECEIVEs are 
issued to complete the 
transfer of all the duta 
from the VTAM buffer. If 
the terminal output mar- 
a5er has issued a Read- 

I 


waht 


Set up addressability 
to the work area. 


Set the parameters 
for the RECEIVE 
macro. 


The RECEIVE macro is 
issued to obtain in- 
put. If the RECFIVE 
is not sutisfied 
with the input, the 
parameters are reset 
for the RECETVE 
macro and control 
loops back to reissue 
the RECEIVE. If a 
lost terminal error 
occurs, control is 
passed to the error 
occurs, appropriate 
error recovery is 


attempted. 


The RECEIVE is satia- 
fied with one of the 
following conditions: 


(a) DATA received. 


@ Read buffer 
satisfied 

@ Paging 

@ Clear 

@® Attention AID 


; Routine Label Ea Notes 


INDSFRR 


TKTIMLU2 ~ 


IKTIMLU2] VTAMERR 

INITFRR 

EXITFRR 

IKTIMLU2Z) POSRESP 
| 


IKTIMLU2| DATARTN 


Buller, the contents of 
the terminal buffer are 
retrieved ints an arca DATARDB 
ani translate] fiom ASCII GETAREA 


tc EBCOIC if necessary. 
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IKT32701| ASCITRA 


Tut pare 


TIM buffer 
1500 bytes 


To 
IKTEXIT 


To 
IKTOMIN 
Parameters 


IPBUFAOR 


Input queve 
To 
IKTIDSX5 


To 
IKTATIN 


To 
IKT32701 


routine | tamer | et 


IKT32701 


Tf the terminal output 
manager has not issued a 
Read-Buffer, a call to 
IKT3270I is issued to 
Validate the data 

received. If the user is 
paging, no input is pro- 
cessed and only an atten- 
tion AID is recognized. 

If the user pressed the 
CLEAR key, the line count 
(TVWALNCT) is reset to 

one, the indicator 
(TVWAFMSC}) is turned on 

to format the screen, and 
the terminal output man- 
ager (IKTOMLU2) is sched- 
uled to unlock the keyboard. 
If there is an attention 
interruption, a user-written 
attention routine is called 
if there is one. If there is 
no user supplied attention 
routine, the IBM-supplied 
attention routine is used. 
In support of full-screen 
mode during paging, a call 
is issued to IKT3270I to 
force an input reshow. 


SCHTOM 
IKTIDS¥5 


IKTATTN 


MO 3.5 (Part 2 of 2) 3270 LU2 Terminal Input Manager (1KTIMLU2) 


Input Process ine 


(b) SIGNAL received. Call 
an installation- | 
written attention 
routine, if there 
is one. Use the IBK~ 
supplied attention 
processcr if there 
is no user-written 
routine. 


{c) CANCEL received. 
Delete the chain 
from the input queue, 
send the response to 
the terminal, and 
schedule the termi- 
nal output manager 
to issue the input- 
error massage. 


(d) LUSTAT received. 
Response is sent to 
the terminal]. For 
component failure, 
control is passed 
to the exit routine. 


{e) CHASE received. 
Send response to 
the terminal. 


(€) -Shutdown complete 
or request shutdown 
received. Send re- 
sponse to the termi- 
nal; ABEND OAB is 
issued, 


Return to step 3. 


(c) The input queue manager 
CIKTQMIN) is called to 
delete the chain from the 
input queue, the response 
is sent to the terminal, 
the input-error flag 
(TVWAERNG) is set, and 
the terminal output manager 
is scheduled. 


If the component is avail- 
able, schedule the terminal 
Output manager and send 

the response to the termi- 
nal. If there is a component 
failure, send the response 
and exit. If integrity is 
lost, turn on input-error 
message (TVWAERNG) and 
formatting-erase-write 

flag (TVWAFMEW), schedule 
the terminal output man- 
ager, and send the response 
to the terminal. If none 

of the above has occurred, 
increase the error-receive 
count by 1 and send the 
response. 


futput 


To 
IKTIDSXS 
To 
IKTATTN 

Parameters 

TPBUFADR 

To Input queue 
IKTOQMIN 
To 
IKTEXIT 


| 
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MO 3.6 (Part 1 of 2) 3270 LU2 Terminal Output Manager (IKTOMLU2) 


Input Processina ouepue 
Through 

Dispatcher 
TOM work area 


TVWA 


_—_-—- — If break-in pro- 
cessing has not begun, 
eall IKT32700. 


—-— — J If change~-direction 
has been received, 
call IKT32700 to 
place read buffer 
convmaand in RU and 
go to step 2. 


ey ee If IKTIMLU2Z has not 

received contents : as 
of data buffer, : 
exit. 

To Caller 
If paging for break- 

in has begun, call 

IKT32700 to place 

contents of data 

buffer in RU and go 

to step 2. If not, 

call IKT32700 to 

place break-in mes- 

sage and paqing indi- 

eator in RU and go to 

step 2. 


This routine takes from the output 
queue, output processed by the TPUT 
routine, and sends it to a VTAM 
buffer for transmission to an IBM 
3274, 3276, or 3278 terminal. Entry 
is through the Dispatcher from one 
of the following: 


IKTLTERM 1.5) 
IKTVTGET 2.1) 
IKTVTPUT 2.2) 
IKTXMTPT 2.3.1) 
UKTIMLU2 3.5) 
IKTO9401 §.1) 
IKTO9409 5.4) 
TETO940C §.6) 
IKTO940E 5.8) 


The RPL fo. the SEND macro is IXTOMLU2 | TOMINIT 


initialized at first entry to INITFRR 
IKTOMLU2. The recovery func- 
tion is established. 


(a) TVWABRIN is checked to see 
if break-in processing has 
begun. 


(b) The read buffer command is 
put in the RU. 


If IXTIMLU2 has received 
the contents of the data 
buffer, and break-in 
paging has begun, place 
the contents in the RU. 
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MO 3.6 (Part 2 of 2) 3270 LU2 Terminal Output Manager (IKTOMLU2) 


Proeessing 


Input 


[2] Chain and 


(a) Check 


Out pute 


send an RU. 


data size 


against user- 
specified RU size: 


e If data size is 
greater than RU 


size, 


send data 


as chain. 

If data size is 
less than or equal 
to RU sige, send 
4s only chain. 


Send the RU to the 
terminal. 


Delete from the output 


queue messages that 
have reached the 


terminal. 


To 


IKTQMOUT 
(MO 4.2) 


Return to step 1 to 
process more output. 


[2] A SEND macro is issued. After the| IXTOMLU2/ INITFRR 
SEND is completed, the recovery 
function is established. If an 
error occurs attempting to send, 
and the chain element at that 
point is a beginning or middle 
element, IKTOMLU2 issues SEND 
CONTROL=CANCEL to cancel the part 
of the chain already sent (so that 
it will not be sent twice}. The 
original SEND may be reissued 
three times before termination is 
required. If the RPL indicates 
that the terminal is in transmit 
mode, and the message to be sent 
is a break message, and the ter- 
minal is a break terminal, a sig- 
fal ia sent (SEND CONTROL#=SIGNAL) 
to the terminal to try to force 
the message through. 


EXITFRR 


Code 3 is passed in OPARMS 
to the output queue manager, 
if positive function manage- 
ment end (FME) was received. 


If the terminal input man- IKTEXIT 
ager is no longer active, 
permanant cleanup is 
required. IKTEXIT ia called 
to free the TOM's work area 
and SRB, and control returns 
to the dispatcher. Otherwise, 
processing returns to step 2 
until there are no more RUs 
to send. 
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MO 3.7 (Part 1 of 2) Exit Routine (IKTEXIT) 


Input From Processina Output 
IKTOMIDS (MO 3.2). 
IKTIMIDS (MO 3.1), 
1KTIMLU2 (MO 3.5), or 
IXTOMLU2 (MO 3.6) 


[2] Free the functional 
recovery routine 
(IKTIOPRR) . 


Tf the terminal output 
manager (TOM) has called 
IXTEXIT, proceed to 


step 4. If the terminal 


Return address 
Work area length 
input manager (TIM) has 


a ea) eee ee called IKTEXIT, the 
status flag TYWATID | TVWATID = 1 | 


is set. 


[rywatis - 0} ——|- —— —-- — — (a) If TOM is not sched- 


uled, free TOM's 
system resource 


block (SRB), clear 
the SRB pointer, set ai 

the status flag 

TVWOTOD, and free | TVWATOD = 1| 


TIM's and TOM's 
work areas. FREEMAIN 


[rwwaTs = 1 }— — Oy eer a men sale fase If TOM is scheduled, 


free TIM's work area 
and proceed to FREEMAIN 
step 5. 


This routine does cleanup. If it If TOM is not scheduled, 
has been called by TIM when TOM the status bit (TVWATIS) 
is not scheduled, it: is equal to zero. In this 
‘ : case, TIM's and TOM's 

e Frees TOM's SRB work areas and TOM's SRB 

® Frees TIM's & TOM'sS work are released. The status 
areas bit (TVWATOD) indicating 

@ Calls IKTLTERM to post the that TOM has exited nor- 
ECB mally and freed the work 


area is set (TVWATOD). 
If it has been called by TIM : : 


when TOM is scheduled, it frees 
TIM's work area. If this routine 
is called by TOM, it: 


@ Frees TOM's work area 

e Frees TOM's SRB 

@ Calls IKTLTERM to post 
the ECB 


Note: TOM can only call IKTEXIT 
if TVWATID is on (TVWATID = 1). 


il | This stack entry is used 
by the functional recovery 
routine (FRR) if an error 
condition is encountered. 


[2] If the third parameter 
field (LIOWA) is not 
zero, TIM has called the 
exit routine. IKTEXIT sets 
the status bit (TVWATID) 
indicating that TIM has 
exited normally and freed 
the work area. 


- 
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MO 3.7 (Part 2 of 2) Exit Routine (IKTEXIT) 


Input Processing Output 


If TOM called IXTEXIT, 

free TOM's work area FREEMAIN 

and SRB and clear the 

SRB pointer. TSBXSRB = 0 


If LOSTERM has 
been entered, 

and the entry 

is from the last 
active 1/0 manager, 
post the LOSTERM 
ECB and proceed to 
step 6. 


Issue STATUS to attach 
waiting task. 


Release the local lock. 


To return 
address 


[5] If LOSTERM was entered, 
the status flag TVWALTE 
is set to one. 
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MO3.8 Attention Routine (IKTATTN) 


From IKTIMIDS (MO 3.1) or 
IKTIMLU2? (MO 3.5) 


Input Proeuss ing 


Reset flags 


There is a STAX exit | | 


available: 


Register 13 


TIM work area 


(a) Increment the unpro- 
cessed attention count, 


(b) Turn off the 1/0 wait L ] 


in progress indicator. 


(c)} Post the RCT, [| 
(ad) Turn off prompting 

indicators. 
(e}) Set the count to indi- 


cate that an attention 
has been received, TSBATTN 


No STAX exit is available. TSBSTAX 
1£ there is an output wait TSBIWAIT 


in progregs, indicate an 
attention has been saceived 
and call STATUS; otherwise, 
turn on the attantion 
ignored flag for the 
Terminal Output Manager, 


For full-ecreen mode, reset 


the full-screen switches. L.] 


Clear the input and output 
queves through the Queue : To 


To 
IKTQMOUT 


To 
Caller 


This routine receives control when [3] 3 F 
the VTAM input buffer contains an eaeoneie Oe a aaa ome ee 


attention attribute character and : 
, pete - in progress, reset TSBOWAIT, 
there ig no user-written attention set the indicator to show an 


ROurLney attention received (TSBATTN) , 

Turn off the error-on-input IKTATTN and call STATUS to notify the 
flag (TVWAERMG), the flashback user of the status of the out- 
flag (TVWANOFB), and the input put request, If there is no 
flush flag (TSBIFLSH) as all output wait in progress, turn 
elements are to be removed from on the attention-ignored flag 
the queues, (TVWAAIGN) for the terminal 

Output manager. 


[2] The numberof unscheduled IKTATTN 
STAX exits (TSBSTAX) is greater 
than the number of unprocessed 
attentions (TSBATTNC). 


For full-screen mode, reset IKTATTN 
the full-screen switch 

(TVWAFSM), the written-over 

switch (TVWAWO), and the full- 

screen TPUT waiting switch 

(TVWAFSW); set the line count 

(TVWALNCT) to zero. 


la) Increase the number of STAX 
taken in the TSB (TSBATTNC). 


(b) Turn off the TSB wait 
switches (TSBOWAIT, 
TSBIWAIT) . 


In non-full-screen mode, IKTATTN 
inorease the line count 

(TVWALNCT) by 1, and set the 

flag to acheduie the terminal 

Output manager (TIMSCHTM). Use 

the queue managers to clear the 

input and output queues of non- 
Cross-memory messages. 


Issue the POST macro to 
indicate the occurrence of 
the region control task 
(RCT) . 


Turn of € the auto-prompting- 
requested flag (TSBAUTON) 
and the flag to prompt the 
user with the next line num- 
ber (TSBSTAUT) . 


Increase the STAX attention 
count (TVWAATTN) by 1. 


4Q 


MO 3.9 Input Data Handling Routine (1KT32701) 


Input fron 
IKTIMIDS (MO 3.1) or 
IKTIMLU2 (MO 3.5) 


. ) 
2] 


This routine receives input data, 
checks it, and places it on the 
input queue for processing by the 
correct TSO command processor. 


fa] Processing begins with the fol- 
lowing registers initialized: 
Reg 6 + TIM work area 
Reg 3 + TVWA 


If the input queve is being 
flushed, a check is made to 


Processing 


Set up addressability of 
TIM work area and TVWA, 


Té user is screan paging, 
ask input queue munager to 
add the reshow value to 
the input queue. 


Tt cequired, convert 
ASCII to EBCDIC 


If required, cali in- 
stallation-written 
translation routine. 


Break multiple Line 
data into line segments. 


Ask input queue man- 
ager to add an ele- ™ To 


ment to the queue. Move IKTUMIN 
a line of data into the 
qucue element. 


Repeat step d until all 
available data has been 
placed on the input 
queue. 


caller 


{c) Data is scanned for input 
line delimiters. Multiple 


line data is broken into 


single lines. MNeaders sare 
placed on each line by the 


HEADPROC routine. 


(hut rae 


TIMBUFF 
1500 bytes 


Parameters 


IPBUFADR 


IKT32701 


determine if another RECEIVE 
is necessary, in which: case 
return is to the caller. If 
another RECEIVE is not neces- 
sary, schedule the output 
manager. 


If the user is paging, a request 
is made to the input queve 
manager to add the reshow value 
(PVWARSHW) to the input queue, 


(a) A check is made for ASCII 
input, which is translated 
by calling the ASCITRAN 
routine. 


If a user translation table 
is available (IKTIDSX2 not 
zero), exit by calling 
IKTIDSX2. Register 0 con- 
tains the address, and reg- 
ister 1 contains the length 
of the data to be 
translated. 


Code 1 is passed in IFARMS 
to ask the queue manager to 
add an element to the bot- 
tom of the input queue. If 
requested by the user, char- 
acter translation is per- 
formed after the element is 
obtained. If processing is 
not done in full screen 
mode, LINECNT is called to 
update the current line 
number and to save the 
input to be flashed back to 
the terminal operator. 
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MO 3.10 Output Data Handling Routine (IKT32700) 


Input 


Prawarscp_- — — 


From 


IKTOMLU2 


TOMPEQCD 


TVWATRAN 
TSEXASCI pees 


ae l. 
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eee | 


The last logical line of 
screen input is put into 
the RU for dispiay at the 
top of the screen, 

An error message is put 
into the RU for display 
at the terminal. 

The character “1" 1s put 
into the RU for placement 
on the next available 
screen line for each 
accepted attention inter- 
ruption. The characters 
"lI" are put into the RU 
for placement on the next 
available screen line 
when an ignored attention 
interruption is detected. 
Code 2 ia passed in OPARMS 
to ask the queue manager 
to obtain the address of 
the message in the next 
available queve element. 
Installation-written exit 


routine IKTIDSX1 is called, 


if present. Then normal 
editing may be performed, 
depending on the return 
code from IKTIDSX1, by 
editing the measage ac- 
cording to the operand 
specified on the TPUT 
macro {EDIT, ASIS, CON- 
TROL, or FULSCRN), and 
placing the edited mee- 
sage into the RU. This 
cycle of obtaining a mes- 
page, editing it, and 
placing it into the RU 
continues until the out- 
put queve is enpty. 


TKTOMIDS (MO 3.2) or 
(MO 3.6) 


--|--y;--- 


Process ind 


Output 


Register 6 


Set up addressability of 


TIM work area and TVWA. 


If TVWAXSCD is on, examine 


TIM work 
area 


Register 9 


scteen size and set up 


parameters. 


Determine type of request: 


(a) Build an output RU. 


1. 


Fiashback 


2. Error message 
3, Attention 
4. Message on queue 


5. Line prompt 


(b) 
(c) 
(a) 


IKTIDSX1 


Format write 
Read buffer request 


Keyboard control for 


break mede. 


(e) 


Restore screen after 


break-in processing. 


Perform data translating 
if necessary. 


Return to caller 


ES (Et ote tine 


IKT32700 ‘- 


To caller 


S. A line number or auto- 
prcmpt character is put 
into the RU, and the 


keyboard is unlocked. 


Format write ia done if 

IKTIMLU2 or IKTUMLU2 finds 
that screen integrity has 
been lost. 


(b) 


During break processing, 
the terminal buffer must 
be read to maintain data 
integrity. A Read Buffer 
command is sent to the 

terminal]. 


In break modc, the keyboard 
is opened after each user 
input, whether or not a 
TGET is outstanding. The 
cursor is repositioned and 
the keyboard is unlocked. 


The buffer contents is 
restored after break 
processing. 


(e) 


If the TVWATRAN bit is on, the 
data is translated according to 
the user translation table 
pointed to by TVWATABO. If 
ASCII translation is required 
(TSBKASC] = 1), translation is 
done using the table pointed 

to by TYVWAATBO, 


MO 3.11 (Part 1 of 2)1/O Functional Recovery Routine (IKTIOFFR) 


Input Processing 


Record crror state 
information, protected 
by FRR. If abnormal 

termination occurs, con- 
tinue with termination. 


If routine was entered 
because of percolation 
from another FRR, or if 
not in SRB mode, continue 
termination. 


If WAIT was issued, reset 
task as dispatchable, 
cancei the session, and 
take a dump. 


G] Otherwise, retry. 


RPL 


LTCBIOER 


(a) If entry was because 
Of an 1/0 error and 
an OAB abnormal termi- 
nation in an 1/0 
manager, exit to lost 

terminal scheduler 

for reconnection. 


To IKTISTGO 


l. If schedule is un- 
successful, con- 

tinve with termi- 

nation. 


If schedule is 
successful, exit. 


To IKTEXIT 
via R/TM1 


oes pauetne | tans | net 


In this routine, "retry" means the 
restoration of registers and passage 
of control to a retry point. Continu 
ation with termination allows perco- 
lation of the termination of a task. 
Percolation is the process of giving 
other higher-level error handler 
routines a chance to recover. 


DJ 


[2] If there is no user code, the 
second digit of the reason 
code is set to l. If there is 
a user code, register 15 is 

set to Q@. 


[3] (a) 


EKTIOFRR 
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MO 3.11 (Part 2 of 2)1/O Functional Recovery Routine (IKTIOFFR) 


Input Processing Out put 


ib) If the entry was due 
to an uncontrollable 
condition, and a re- 


cursion after the 

I/O manager was re- 

initialized, exit to 

lost terminal shed- 

uler; indicate to 

cancel user. To IKTISTOO 


1. If schedule is un- 
successful, con- 
tinue with termi- 
nation. 


If schedule is 
successful, exit. 


To IKTEXIT 
via R/TM1 


If entry was recursive 
after retry was at- 
tempted, exit to 

lost terminal sched- 
uler and indicate 
reconnection. 


To IKTISTOO 


If FRR was entered 
for the first time 
with an abnormal 
condition, retry, 

to restore registers 
to condition at 

time of entry. 


To 1/0 manager 
via R/TM1 


(b) The error occurred in SRB IXTIOFRR| RETRY 
mode and was duce to a 
macnine check, program 
check, or other uncontroi- 
lable condition. 


Logon reconnection com- IKTIOFRR| EXIT 
pletely reconstructs all 

local control blocks and 

local work areas for the 

1/0 managers. 
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MO 3.12 Lost Terminal Exit Scheduler (IKTISTOO) 


Input From IKTIOFRR processing Output 


[1] Obtain storage for UECB. 
If storage is not avail- 


able, set return code eS 
to 4 and return to 
REQSTORE 


IKTIOFRR. 


[2] Build UECB. 


(3) Schedule lost terminal 
exit routine. Set re- 
turn code to 0. 


To Caller 


UECTSKID 
UECACB 


VECUSFLD 


UECRSNBT 


The VECB is used by the lost 

terminal exit routine. 

TPQUEUVE is iseved to queue the 4 
UECB to the UECBPAB. 
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MO 4.1 (Part 1 of 3) Input Queue Manager (i KTQMIN) 


Trpeut From 

IKTLTERM (MO 
IKTVTGET (MO 
IKTIMIDS (MO 
IKTTIMRT (MO 
IXTO9401 (MO 
IK¥32701 (MO 


Reaister | 


IKTINLU2 (MO 


Parameters (TPARMS} 


This routine adds, updates, and 
removes input queue elements. 


The request code in IPARMS 
indicates which service to 
perform, 


(a) Storage is allocated 
(GETCELL for normal size 
element, GETMAIN for larger 
than normal size element) 
for the element and pointers 
are manipulated to add the 
element to the queue. If 
GETCELL or GETMAIN is unsuc- 
cessful, ABEND OAD is issued 


Input parameters (IPARMS): 
Request code (IPREQ) = 1 
Buffer size (IPBFSZ) = 
Message length 

Plags (IPFLAGS) = Flag 
settings requasted by 
caller 


Output parameters (IPARMS): 
Return code (IPRC): 
1 = Successful 
2 = Unsuccessful; no 
room for element 
Buffer address 
(IPBUFADR) = 
Location of message 
srea of queue element 


Input parameters (IPARMS) : 
Request code (IPREQ) = 2 


Output parameters (IPARMS) : 
Return coda (IPRC): 
1 = Suctessful and there 
are more elements on 
the queue 
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1.5), 
2.1), 
3.1), 
3.3), 
5.1), 
3.9), 


IKTATTIN (MO 3.8), or 


3.5) 


Processing 


0) Perform one of the follow- 
ing input queue services: 


Output 


(a) Add an element to the 
bottom of the queue 
(code 1). 


Obtain the Address of 
the message in the 
next available queue 
element (code 2). 


Remove an element from 


the queue (code 3). 


Update the data 
pointer, flags, and 
byte count in a par- 
tially used element 
(code 4). 


Remove all elements 
from the queue 
(code 5). 


Remove from the queue 
elements that are 
marked unavailable for 
TGET, starting at the 
bottom, until an 
available element is 
found (code 6). 


Mark unavailable ele- 
ments available for 
TGET (code 7). 


To Caller 


protesting] unten | | jctes | outine | tates | net 


2 = Successful and this 
is the last element 
on the queue 

3 = Unsuccessful; the 
queue is empty 

Buffer addreas (IPBUPADR) 
= Location of queue 
element's message area 

Buffer size (IPBFSZ) = 
Message length 

Plags (IPFLAGS) = Flag 
settings requested by 
caller 


The element's storage is 
freed (FPREECELL or 

PREEMAIN, depending on how 
it was allocated) and 
pointers are manipulated to 
remove the element from the 
queue. If FREECELL or 
FREEMAIN is unsuccessful, 
ABEND OAD is issued. If any 
tasks are waiting because of 
buffer overuse they are dis- 
patched (STATUS macro 
routine). If a task is wait- 
ing in another address 

space ,IKTXMTPT is rescheduled 
(SCHEDULE SRB) in this 
address space. 


Input parameters (IPARMS): 
Request code (IPREQ) = 3 


Output parameters (IPARMS): 
Return code (IPRC): 
1 = Successful and 
there are more ele- 
ments on the queve 


Sarameters (IPARMS) 


MO 4.1 (Part 2 of 3) Input Queue Manager (IKTQMIN) 


Taput Processing Output 
E From R/TM 


Handle queve manager 
errors. 


To R/™ 


From R/TS 


Handle element verifica- 
tion errors and queue 
manager FRR errors. 


To R/T™ 


rote ovine | tater | et | jot routine] tatet | net 


2 = Successful and (f) The storage occupied by the 
there are no more 
elements on the queue 
(d) Updating is required when UPDATE 
the TGET requester's buffer 
is smaller than the message 
in the input queue. 
Input parameters (IPARMS) : 
Request code (IPREQ) «= 4 
Buffer address (IPBUFADR) 
=» Address of first 
unused byte of message 
Output parameters (IPARNS): 
Return code (IPRC): 
1 = Successful 
2 = Unsuccessful; the 
queve is empty 
Storage occupied by the CLEARI 
elements is freed (FREECELL 
and/or FREEMAIN), and the ; 
current line number is 
adjusted for line prompting 
according to the number of 
elements removed from the 
queue, 
Input parameters (IPARMS): 
Request code (IPREQ) = 5 
Output parameters (IPARMS): 
None 


@lements marked unavailable 
is freed (FREECELL or 
PREEMAIN) and: pointers are 
manipulated to remove the 
elements from the queue. If 
FREECELL or PREEMAIN is 
unsuccessful, ABEND OAD is 
issued. If any tasks are 
waiting because of buffer 
overuse they are dispatched. 
(STATUS macro routine). If 
a task is waiting in another 
address space, IKTXMTPT is 
rescheduled (SCHEDULE SRB) 
in this address space. 


Input parameters (IPARMS)1 
Request code (IPREQ) = 6 


Output parameters (IPARMS): 
None 


Elements are marked avail- 
able when there is no room 
on the input queue for more 
elements. 


Input parameters (IPARMS): 
Request code (IPREQ) = 7 


Output parameters (TPARMS): 
None 
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MO 4.1 (Part 3 of 3) Input Queue Manager (IKTQMIN) 


Input Processing Output 


[2] IKTQMFR1 1s the first queue 
manager FRR. It receives control 
when the queue manager encounters 
an error. It builds a queue 
verification parameter List 
(QVPL), calls IEAVEQV}3 to verify 
and correct the list, logs the 
TVWA into the SDWA, and retries 
the queue manager once. 
(TEAVEQV3 calls IKTQMEV to 
ensure that queue element size 
and buffer size are acceptable. 
If an unacceptable element is 
found, message IKTOO400I (input 
data Tost) is sent to the 
terminal.) 


IKTOMFR2 is the second queue 
manager FRR. It receives control 
when an error occurs during 


IKTQMFR1 processing. If the 
element verification routine 
(IKTQOMEV) has failed, the 
element is marked unacceptable 
and verification continues. 

If the queue manager FRR has 
failed, the TVWA is logged into 
the SDWA and termination 
processing continues. 
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routine} tater | net | 


MO 4.2 (Part 1 of 3) Output Queue Manager (IKTQMOUT) 


Trput Processin4 Output 


A teenie 


trom 

JKTLTERM (40 1 
IKTVTPUT (MO 2 
IKTIMIDS (M0 3 
(KTTLART (MO 3 
SKTTOMRY (MO 3 
LKTXMTPT (MO 2 
1xTO9401 (MO 5. 
LKTLUOGR (MO 1.3), 
1KT32700 (MO 3.10), 
IKTATIN (MO 3.8), or 
IKTOMLU2 (MU 3.6) 


Reyister 1 


Perform one of the follow- 


Parameters (OPARMS) ing output queue services: 


(a) Add an element to the 
bottom of the queve 


(code 1). 


Output § 
querac ff 
| element 


Obtain the address of 
the message in the 
next available queue 
element {code 2). 


Register 1 


Remove an element from Faramoters (OPARAMS) 
the queue (code 3}. 

Update the data 
pointer, Flaqs, and 
byte count in a par- 
tially used element 
(code 41. 


Remove all elements 
from the queue 
{code 5). 


Reset the next-element 
pointer to puint to 
the top of the queue, 
and obtain tha address 
ef the message in the 
next available queue 
clement (code 6), 


head 


: ~ is | : 


This routine adds, updates, and 2 = Successful and 
removes output queue elements. this ia the last 
element on the queue 
2] The request code in OPARMS 3 = Unsuccessful: the 
indicates which service to queue is empty 
perform, Buffer Address (OPBUFADR) 
= Location of queue 
(a) Storage is allocated BLDELE element's message area 
(GETCELL for normal size Buffer size (OPBFSZ) = 
element, GETMAIN for larger Message length 
than normal size elemant) Flags (OPFLAGS) « The 
for the element and pointers element's flags 
are manipulated to add the 
element to the gueue. If (c) The element.'s storage is DELEL 
GETCELL or GETMAIN is unsuc- freed (FREECELL or FREEMAIN, 
ceasful, ABEND OAD is issued depending on how it was 
allocated) and pointers are DELETN 
Input parameters (OPARMS): manipulated to remove the 
Request code (OPREQ) = 1 element from the queue. If 
Buffer size (OPBFEZ) = FREECELL or PREEMAIN is 
Message length unsuccessful, AREND OAD is 
Flags (OPFLAGS) = Flag issued. [f any tasks are MREDTS? 
settings requested by waiting because of buffer 
caller overuse they are dispatched 
(STATUS macro routine). If 
Output parameters (OPARMS): a4 task is waiting in another 
Return code (OPRC): dddress space, IKTXMTPT is 
1 = Successful rescheduled (SCHEDULE SRB) 
2 = Unauccessful; no in this address space. 
room for element 
{parmlib limit (d) Undating is required when UPDATO 
exceeded) the amount of cata that can 
Buffer address (OPBUFADR) be transmitted with a SEND 
= Location of message is smaller than the message 
area Of queuc element on the output queue, 
(b) Input parameters (OPARMS) : Input parameters (OPARMS) : 
Request code (OPREQ) = 2 Request code (CPREQ) = 4 
Buffer address (OPBUFADR) 
Output parameters (OPARMS): = Address of first 
Return code (OPRC): unused byte of message 


lL = Successful and 
there are more ele- 
ments on tha queve 
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MO 4.2 (Part 2 of 3) Output Queue Manager (IKTQOMOUT) 


Input 


Notes 


(f) 


From R/T 


Processing 


the top of the 
(code 7). 


Add an element 


(code 8B). 


errors. 


From R/T™ 


Output parameters (OPARMS): 
Return code (OPRC): 
1 = Successful 
2 = Unsuccessful; the 
queue is empty 


The element's storage is 
freed (FREECELL or FREEMAIN) 
and pointers are manipulated 
to remove all elements not 
from another address space 
from the queve. If FREECELL 
Or FREEMAIN is unsuccessful, 
ABEND OAD is issued. If any 
taBKks are waiting because 

of buffer overuse they are 
dispatched (STATUS macro 
routine). If a task is wait- 
ing in another address space 
IKTXMTPT is rescheduled 
(SCHEDULE SRB) in this 
address space. 


Input parameters (OPARMS): 
Request. code (OPREQ) = 5 


Output parameters (OPARMS): 
None 


Input parameters (OPARMS) : 
Request code (OPREQ) = 6 


Output parameters (OPARMS): 
Return code (OPRC): 

1 = Successful and there 
are more elements on 
the queue 

2 = Successful and this 
ia the last element 
on the queue 

3 = Unsuccessful: the 
quéue is empty 


manager PRR errors. 


routine | aber | net 


(g) Reset the next~-element 
pointer to point to 


top of the queue 


Handle queue manager 


Nandle element verifica- 
tion errors and queue 


Output 


queue 


to the 


To Caller 


To R/™ 


To R/'™ 


ee 


Buffer size (OPBUFSZ) = 
Message length 

Buffer address (OPBFADR) 
= Address of first byte 
of message 

Plags (OPFLAGS) = The 
element's flags 


(g) Input parameters (OPARMS): 
Request Code (OPREQ) = 7 


Output parameters (OPARMS): 
None 


Storage is allocated 
(GETCELL or GETMAIN) for the 
element and pointers are 
manipulated to add the ele- 
ment to the queve. If 
GETCELL or GETMAIN is unsuc- 
cessful, ABEND OAD is 
issued. 


Input parameters (OPARMS): 
west code (OPREQ) = & 
Buffer size (OPBFSZ) = 
Message length 
Flags (OPFLAGS) = Flag 
settings requested by 
caller 


Output parameters (OPARMS) : 
Return code (OPRC): 
1 = Successful 
2 © Unsuccessful; no 
room for the 
element 
Buffer address (OPBUFADR) 
= Location of message 
area of queue element 


MO 4.2 (Part 3 of 3) Output Queue Manager (IK TQMOUT) 


Input 


IKTOMFR1 is the first queve 
manager FRR. It receives control 
when the queue manager 
encounters an error. It builds 

a@ queue verification parameter 
list (QVPL), calls LEAVEQV3 to 
verify and correct the list, 
logs the TVWA into the SDWA, and 
retries the queue manager once. 
(IEAVEQV3 calls IKTQMEV to 
ensure that queue element size 
and buffer size are acceptable. 
If an unacceptable element is 
found, message IKT004011 

{output data lost) is sent to 
the terminal.) 


IKTQMFR2 is the second queue 
manager FRR. It receives control 
when an error occurs during 
IKTOMPRL processing. If the 
element verification routine 
(IKTQMEV) has failed, the ele- 
ment is marked unacceptable and 
verification continues. If the 
queue manager FRR has failed, 
the TVWA is logged into the SDWA 
and termination processing 
continues. 


Processing 


a 


Output 
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Sl 


MO 5.1 Terminal Control Macro Branching Routine (IKTOOOSD) 


Input From 16C0009p Processing 


Register 0 Check that entry code is 


valid; if it is, route 

SS ee en ee control to appropriate 
terminal control macro 
module. 


2) The entry code isa in the high- 
order byte of register 0: 


Code Module 


IKTO9401 
Invalid 
Invalid 
IKT09404 
IXT09405 
Invalid 
Invalid 
Invalid 
IKT09409 
IKTO940A 
IKTO940B 
IKTO940C 
IXTO930D 
IKTO940E 


WOOMwwWwAWM e&w Ye 


* 
m= Oo ~J aw 


IXTOS40F 
Invalid 

IKT09412 
IKT09413 
IKTO9414 


www wun wu 


— pet 
ta A 
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Output 


MO 5.2 TCLEARQ Terminal Control Macro Routine (1KT09401) 


Input From IKTO009D Processing 


Register 1 


<0 = Clear input queue 


(1) Clear the input queue if 


0 = Clear output queve mania sees, requested: 


This routine services the TCLEARQ 
macro instruction for TSO/VTAM 
terminals. It invokes the queve 
manager to clear the input or output 
queue. 


fa) (b) The following parameter is 
passed to the input queue 

manager in IPARMS: 
Request code (IPREQ) = 5 


The appropriate terminal 
output manager is scheduled 
(SCHEDULE SRB) if it is 
available (IVWATAS) and not 
already scheduled (TVWATIS). 


Output queue is cleared of 
but cross-memory messages. 


The following parameter is 


passed to the output queve 
manager in OPARMS: 
Request code (OPREQ) © 5 


Return codes: 
Successful 
4 Register 1 at entry contained 
a value greater than zero. 


(a) Indicate to flush 
typed-ahead input snd 
to halt prompting. 


Ask the queue manager 
to clear all elements 
from the queue. 


Schedule the terminal 
Output manager. 


‘arlanieteniendonieadaniantentententanteneatenien 


— [2] Clear the output queue if 
requested: 


(a) Ask the queue manager 


to clear all elements 
from the queue. 


IKTO09401 


Output 


Register § 


TSB 


TSHIFLSH = °1'B 
TSHSPIT = "I'S 


To 
IKRTQMOUT 
(MO 4.2) 


To Caller 
(S¥C exit) 
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MO 5.3 STBREAK Terminal Control Macro Routine (IKT09404) 


Input From IKTOOO9D Processing Output 


Register 1 


Leftmost bit: 
1 = STBREAK NO ——= ft] Indicate STBREAK NO or TSBNOBRK bit: 
STBREAK YES in the TSB. 1 = Breakin 

prohibited 
0 = Breakin 
allowed 


0 = STBREAK YES 


TCAST (LU2 only) 


To Caller (SVC exit) 


This routine services the STBREAK 
macro instruction for TSO/VTAM 
terminals. It sets a bit in the TSB, 
depending on the operand specified 
with STBREAK, to indicate whether TSO 
is allowed to interrupt input trans- 
mission. 
The TCAS key (key 6) is acquired |IKT09404 
(MODESET) for accesa to the 
TSB. If the terminal user is no 
longer connected to TSO, control 
returns immediately to the 
caller. If the terminal is a 
3270 (TSBXTMTP), the use of 
STBREAK is invalid and the TSB 
is not set. 
If TCASMDSW = 1, mode switching 
is allowed for LU2 terminals. 
Return codes: 
Successful 
Register 1 at entry contained a 
nonzero value in bits 1-31 
STBREAK was issued for a 3270 
terminal 
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MO 5.4 STCOM Terminal Control Macro Routine (1KT09405) 


Input Processing 


Frorm LKTOO03D 


Register 1 


Leftmost bit: 
1 = stcom yes |. _} — _ — — — GJ Indicate STCOM YES or 
0 = STCOM NO STCOM NO in the TSB. 


Queprual 


TSB 


TSBITOFF bit: 
1 = Communication 
prohibited 


0 = Communication 
allowed 


fo Caller 
(SVC exit) 


This routine services the STCOM macro 
instruction for TSOAVTAM terminals. It 
sets a bit in the TSB, depending on 
the operand specified with STCOM, to 
indicate whether a terminal is allowed 
to accept messages from other 
terminals. 
f1] The TCAS key (key 6) is ; 
acquired (MODESET) for accese 
to the TSB. 
Return codes: 
0 Successful 
4 Input parameter error 
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MO 5.5 STAUTOLN Terminal Control Macro Routine (i1KT09409) 


Input Processing Output 
From 1KT0009D 


Register 0 


Eo ed Se fa) Set the start and incre- 


ment values for Line 
numbering in the TSB. 


Register 1 


TSBAUTON 
TSBAULST 


Set prompt switches. TSBSTAUT 
TSBAUTOC 
TSBSPIT 


Increment value 


Schedule the terminal 
output manager to send the 
first prompt line, 


To Caller 
(sve exit) 


This routine services the STAUTOLN 
Macro instruction for TSO/VTAM 
terminals. It sets values in the TSB, 
according to the operands specified 
with STAUTOLN, that are used in provid 
ing automatic line numbering. 


If the start and increment IKT09409 
values are not between 0 and 
99,999,999, control returns 
immediately to the caller. 


[3] The appropriate terminal output /IKTO09409 
- manager is scheduled (SCHEDULE 
SRB) if it is available 
(TVWATAS) and not already 
scheduled (TVWATIS). 


Return codes: 
6 Successful 


4 Start or increment value not 
within allowable limits 
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MO 5.6 STSIZE Terminal Control Macro Routine (IK TO940A) 


Input Processing Wutput 
From IKTO0009D 


Register 1 


Set the terminal's logical 


TSs8 
line size in the TSS. pees 


Set the number of lines in TSRLNNO 
the TSB if the terminal is 
a 3270 display station. —— 


Set switch in TVWA, rvwaxsco 


TSB 
TSBDBPLY switch 


Register 6 


To Caller 
(SVC exit) 


instruction for TSO/VTAM terminals. It 
sets values in the TSB, depending on 
the operands specified with STSIZE, to 
indicate the logical line size and, if 
a display station, the number of lines 
on the screen. 
[2] tne TCAS key (key 6) is acquired 
(MODESET) to access the TSB. 
(2) Nonstandard screen dimensions DISPROC 
are allowed. 
Return codes (in hex): 
Q Successful 
4 Invalid parameter 
B Screen size not specified or 
line size not specified for 
3270 
C Nonstandard screen size 
specified 
(3] TSB screen dimensions may DISPROC 
have changed. The output 
manager should check the 
ecreen size to ensure com- 
patibility with the terminal. 
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MO 8.7 STAUTOCP Terminal Control Macro Routine (1K TO940C) 


Input Processing Output 
From IKTOOO9D 


"1"B 
Set character-prompt l°B 
values in the TSB. *1"B 

‘O's 
Schedule the terminal ‘O's 
output manager to send the "6D16'X 
first prompt character. 


To Caller 
(SVC exit) 


This routine services the STAUTOCP 
macro instruction for TSO/VTAM 
terminals. It sets values in the TSB 
to start automatic character prompt- 
ing. 


G3) lf register 1 at entry is not 
zero, or if the terminal is a 
display terminal (TSBDSPLY), the 
TSB is not set. 


[2] The appropriate terminal output |IKTO940C 
manager is scheduled (SCHEDULE 
SRB) if it is available 
(TVWATAS) and not already 
scheduled (TVWATIS). 


Return codes: 
0 Successful 
4 A parameter was specified in 
register 1 but none was expected 


MO 5.8 SPAUTOPT Terminal Control Macro Routine (IKT0940D) 


Input Processing Output 
From IKXTOO09D 


Sy ae I€ requested, set TSB 
values that halt auto- TSBAULST = ‘O'R 
TSBAUTOC awitch oy matic line numbering. TSBAUTOC =~ '0'R 


TSBAUTON = ‘0°D 
u—-—-— Tt requested, set TSB 
values that halt auto- 


matic character prompting. 


To Caller 
(SVC oxit) 


This routine services the SPAUTOPT 
macro instruction for TSO/VTAM 
terminals. It seta values in the TSB 
to stop automatic line numbering or 
automatic character prompting. 


The TCAS key (key 6) is 
acquired (MODESET) to access 
the TSB. 


Return codes: 
Successful 
A parameter was specified in 
register 1 but none was expected 
Neither line numbering nor 
character prompting was in use 
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MO 56.9 RTAUTOPT Terminal Control Macro Routine (IKTO940E) 


Input Processing Output 
From IKTOOO9D 


TSBAULST swatch Fm - he HO If requested, set TSB 
5 values that restart TSBAUTON = '1°B 
TSBAUTOC switch -—-A automatic line numbering. TSBSTAUT = ‘1'B 


' TSBSPIT = 'O'B 
i. —— If requested, set TSB 

values that restart 

automatic character 

prompting. 


Schedule the terminal 
output manager to prompt 
the user. 


To Caller 
(SVC exit) 


, ae 


This routine services the RTAUTOPT 
macro instruction for TSO/VTAM 
terminals. It sets values in the TSS 
to restart automatic line numbering 
or automatic character prompting. 


[3] The appropriate terminal output |IKTO940E 
manager is scheduled (SCHEDULE 
SRB) if it is available 
(TVWATAS) and not already 
scheduled (TVWATIS). 


Return codes: 
0 Successful 
4 A parameter was specified in 
register 1 but none was expected 
§ Prompting was not in use 
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MO 5.10 STTRAN Terminal Control Macro Routine (IKTO940F) 


Input From [KkTO00N9D Processing Output 


Rogister 1 


a | User-written _ 
- 
| 


translation 
tables 


Input table 


Terminal character 
= 


This routine services the STTRAN 
macro instruction for TSO/VTAM 
terminals. It sets up, modifies, or 
discontinues the use of translation 
tables, depending on the operands 
specified with STTRAN. 


1] If TABLE and NAME are specified, 
the name of the member that 
contains the translation tables 
is put into the TVWA, storage 
is allocated (GETMAIN) locally 
for the tables, and the pair of 
tables (default or user-written, 
depending on TVWATROF) is copied 
into the local storage. (Default 
tables are coded in IKTO940F, 
They translate each character 
to itself. They are provided to 
allow TCHAR and SCHAR to be 
specifled without having 
previously specified TABLE and 
NAME.) 


If NOTRAN is specified, 
FREEMAIN frees the tables in 
use, and translation indicators 
in the TVWA are set to turn off 
translation. 


If TCHAR and SCHAR are specifiad 
default translation tables are 
provided if necessary, and the 
translation characters are put 
into the translation tables. 


Putput table aT 
Default 
transiation table 
Input table 
Autpout table 
Register 0 
Entry code: OF 
Flags: 
Te... .2.. ™ NOTRAN : 
el... «2.2. * NOCHAR 
-ol, ..-. * TCHAR, SCHAR 


Perform one of the follow- 
ing functions based on the 
STTRAN operand speci fied: 


TABLE=, NAME= 
Make the specified trans- 
lation tables available 
for use by copying them 
into local storage. 


NOTRAN 

Free the tables in use. 
TVWATRAN = '0’°B 
TVWATRDF = ‘'0'8 
TVWATRNM = blank 


TCHAR=, SCHAR# 
Put the specified char- 
acters into the trans- 
lation tables. 


NOCHAR , NAME= 

Pree the tables in use 
(if default tables) or 
provide the name of the 
member containing tha 
tebles to the TERMINAL 
command routine {if 
user specified tables). 


To Caller (SVC exit) 


rots mucin | tater | ret | jwotee [routine] tate | 


If NOCHAR and NAME are 
specified, and if default tables 
are in use, PREEMAIN frees the 
tables, and translation indi- 
cators in the TVWA are set to 
turn off translation. Tf user- 
written tables are in use, the 
name of the member containing 
the tables is passed to the 
TERMINAL conmand routine. 


Return codes: 

O Successful 

4 NOTRAN or NOCHAR was specified 
but translation was not in 
effect. 

8 TABLE or NOCHAR was specified 
but an addrese was not provided 
with the NAME operand. 

C Internal error - an unidenti- 
fiable flag was set in input 
register 0. 
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Translation tables 


Tnput table 
Output table 


MO 5.11 STFSMODE Terminal Control Macro Routine (1IKT09412) 


Input P 
From IKTOQ09D 


Register 1 

Bit 0: 
1 = STFSMODE ON 
0 = STFSMODE OFF 


Bit ls: 
1 = initial call 
0 = not initial 
cali 


Bits 24-31: 
RSHWKEY value 


This routine services the STFSMODE IKTO9&12 
Macro instruction for TSO/VTAM 
terminals. It sets bits in the TVWA, 
depending on the operand specified 
with STFSMODE, to indicate whether an 
IBM 3270 display terminal is to 
Operate in full screen mode. 


The line counter (TVWALNCT) is 
set to 1. TVWARSHW is reset to 
the system default value (PA2). 


Return codes: 
0 Successful. 
4 Invalid parameter specified to 
the Svc. 
8 Invalid terminal type. This 
macro instruction is valid only 
for. IBM 3270 display terminals 
that use TSO/VTAM. 
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rocessing 


Set full screen mode 
indicators: 


(a) Indicate that full 
screen mode is on, 


or 


(b) Indicate that full 
screen mode is off. 


Output 


‘O°B 


TVWAFSM = 


To Caller 
(sve Exit) 


MO 5.12 STLINENO Terminal Control Macro Routine (1KT09413) 


Input Processing Output 
From IKTO009D 


Register ! 


Flags (leftmost bit): 
1 = MODE=00 
0 = MODE=-O0FF 


Reserved 


[1] Store the number of the 
screen line on which the 
next non- full-screen 
message is to appear. 


| 
I 
1 
en [2] If requested, set full 


screen mode indicators: i 
(a) Indicate that full 


screen mode is on, 
or 


(b) Indicate that full 
screen mode is off. 


To Caller 
(svc Exit) 


This routine services the STLINEND 
macro inatruction for TSO/VTAM 
terminals. It sets values in the 
TVWA for IBM 3270 display terminals, 
according to the operands specified 
with STLINENO: it sets the number 
of the screen line on which the next 
non-full-screen message should 
appear, and it indicates whether the 
terminal is to operate in full 
screen mode. 


Return codes: 
0 Successful. 
4 Invalid parameter specified to 
the SVC. 
8 Invalid terminal type. This 
macro instruction is valid only 


for IBM 3270 display terminals 
that use TSO/VTAM. 

The line number specified was 0 
or it was greater than the 
maximum number of lines allowed 
for the terminal in use. 
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MO 8.13 STTMPMD Terminal Control Macro Instruction (1KT09414) 


Input 


From 
{KTOCOID 


Register 1 


0: 


MODE#ON 
MODE=OFF 
1: 


KEYS#ALL 
KEYS=NO 


This routine processes the 
STTMPMD macro for TSO/VTAM 
terminals. It sets bits in 
the TSB to indicate whether 
the terminal control 
routine is active for this 
terminal and whether the 
PAl and CLEAR keys are to 
be passed to the applica- 
tion program as data. 
[1] If the terminal control IKTO9414 
; routine is active, set 
TSBATMP to 1; if not, 
set TSBATMP to 0. ; 
If the PAl and CLEAR 
keys are to be passed, 
set TSBKEYS to 1; if 
not, set TSBKEYS to 0. 


IKTO9S1Y 


[2] 


Return codes: 
Q Successful. 


y 


Invalid parameter 
was specified to 
svc. 


Invalid terminal 
type was specied; 
not 4 display. 
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Processing Putlypuet 


| 
| 


TSBATMP = 1 (ON) 


i(] Set terminal] control mode. 
| 0 (OFF) 


jl 


[2] Set keys mode. TSBKEYS = 1 (ALL) 


0 (NO) 


To Caller 
(sve Exit) 


—_ a ap a ae eee ae ee a ae 29s aD qa ae eee eae oe a 


This section describes VTIOC modules and shows control flow among then. 
There are two parts: 


e Figures (Figures 4, 5, 6, 7, 8, and 9) showing control flow among 
the VTIOC asodules 


e A description of each VTIOC module giving: 
Names 
MO Diagras - that descrikes the module 
Function 
Entry from 
Registers at Entry - contents of relevant registers 
Exit to 
Registers at Exit - contents of relevant registers 
External References 
Control Blocks Used 
Mapping Macros Used 
Executable Macros Used 
Module Attributes 
Lock Dependency - requirements at module entry 
Messages - detected by and issued from each module 
Abend Codes 
Data Sets 


The module descriptions are arranged alphamerically by module name. 
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nar cae as oe =] 


rf 
i IKJEFLA I 


LOGON | 
{ Initialization | 
ALL IKTXINIT 
| @ For TSO/VTAM VTIOC 
I} logon ( Initialization 
ga ok eek oe eee) 
e OPNDST RPL 
@ Initialize TIM 
and TOM 
r amas ae wR aa a= 
1 IKJEFLE 
OGON/LOGOFF ! 
Verification \ 


i 

{ © For TSO/VTAM 
| logon | 
| een re ema 


IKTXLOG 


Extended Logon 


SSS 

I IKJEFLEA ft 

| Parse/Scan 

} interface 

| | 
(CALL : 


l 
} @ For TSO/VTAM 
[ re-LOGON j 


eee 


RECONNECT 


via 
VTAM 


CALL 


IKTRPLXT 
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VTIOC Terminal Control Macros Module Flow 
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JKTASCII_--_ASCII-EBCDIC Translation Tables 
N 


Assembly Module: IKTASCII 
Object Module: IKTASCII 
Alternate Entry Points: None 
Lead Module: IKTASCII 


BC_Ciagram: None 


Function: This module ccnsists of translation tables for 3270 and 


3767/3770 terminals that are used by the IyvO managers to translate 
input from terminals with ASCII keyboards from ASCII code to EBCDIC 
code, and output from EBCDIC code to ASCII code. 


Entry from: N/A 


Registers at Entry: N/A 


Executable Macros Used: None 


Sodule_ Attributes: Not executable 


2 ow om EP EP oe om ee ee ee wo oP a = a SS owe oe ae oe we es oe war ot ee a ee a ee ee ee ow ae a oe oe om om 62 ar oe oe oe ae 


Asseubly Module: IKTASTPT 
Ckject Module: IKTASTPT 
Alternate Entry Points: None 
Load Module: IGCc0009C 


BC_Diagraa: 2.3 


Function: This routine handles TSO/VTAM TPUT with ASID requests for 


the calling address space. It takes data from the TPUT requester's 
tuffer, edits it, and places it in the TVCS for handling by IKTXMTPT. 


Entry from: IGc0009c 


Register 3: Address of CVT 
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Register 4: Address of TCE 


Register 5: Address cf SVRE 
Register 8: Address of ASCE 
Register 9: Address cf target TSB 


Exit to: 


Caller (SVC exit) 


ee es ee oe ee 


Rejister 15: Return code (in hex): 


00 
04 


OC 


14 


Successful. 

A terminal outfut buffer was not available or ENQ resources 
were not available, and TPUT NOWAIT was specified. 
NOINTERCOM (on PROFILE command) was specified by the target 
terminal operator. 

The terminal cculd nct be reached. 


External References: IKTXMTPT 


— ee ee ee ee ee 


Ccntrol Blocks Used: ASCE, ASVT, CVT, PSA, RB, SRB, TCAST, TCE, TCT, 


TSE, TSBX, 


TVCS, WSAVT, XSA 


ping Macros Used: CVI, IEEXSA, IEFTCT, IHAASCB, IHAASVT, IHAPSA, 


BarFing_ fa 
IHA 


— oe ee ee oe oe oe 


RE, IHASRB, IHAWSAVT, IKJTCB, IKJTSB, IKTICAST, IKTTVCS 


Executable Macros Used: DEQ, ENQ, FREEMAIN, GETMAIN, MODESET, SCHEDULE, 


— oe ee ee ee ee 


a ae 


SETLOCK, TESTAUTH, WAIT 


Module Attributes: Reenterable, privileged, enabled, key 0 


Lock Dependency: This module is entered with the local lock held. } 


——~ as as ee oe nd 


a oe oe 


<—— ame wee ee ee ee ee ee ee ee ee es — 2 ee oo we 


Assembly Module: IKTATTN 


Object 


Module: IKTATIN 


Alternate Entry Points: Nene 
Load Module: IKTIOMOO 


ee 


IKTATTN handles attention and attention-ignored conditicns. 


Entry from: IKTIMLU2 or IKTIMIDS 


Registers_at_Entry: 

Register 13: Address of a save area 
Exit_te: 

Caller: 
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Normal ) 


Registers at Exit: N/A 


Fxternal References: IKTQMIN, IKTQHMOUT, POST, STATUS 


Ccntrol Blocks Used: ASCB, CVT, PSA, SCVT, TCAST, TIMNWA, TSE, TSSX, 


Mapping Macros Used: CVI, IHAASCB, IHAPSA, IHASCVT, IKJTSB, IKTECU, 
IKTIPARM, IKTOPARM, IKTTCAST, IKTTIMWA 


Fxecutable Macros Used: None 


a ae oe ow om OD 8 ee 8 OD oe Ow ee 2 88 ee a oe 


_ = a» = a 


Assembly Module: IKTAYS8 

Object Module: IKTAY81 

Alternate Entry Points: IKTAY82, IKTAY83 
Load Module: IGCC001C 


MNC_Diagram: 1.6, 1.7, 1.8 


Functicn: This routine handles TCAS termination and TSO/VTAM terminal 


user address space termination, and cleans up TPUT with ASID requests 
to a TSO/VTAM address space from a terminating TSO/TCAM address space. 


IECDAYS (in load module IGCQ001C) to one of the following entry points: 


IKTAY81: When TCAS is terminating 

IKTAY82: When a TSO/VTAM terminal user's address space is 
terminating 

IKTAY83: When a TSO/TCAM terminal user's address space is 
terminating and ASID TPUTS to TSO/VTAM address spaces 
are outstanding (QTIP 29 equivalent) 


Ic entry peint IKTAY81: 


Register 4: Address of TCAST 

Register 8: Address cf TSE 

Register 13 Address of R/TH2 register save area 
Register 15 Address of entry point IKTAY81 


Ic entry point IKTAY82: 
Register 4: Address of TCAST 


Register 8: Address of TSB 
Reyister 11: Address of RMSPL 
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Register 13: Address of R/TM2 register save area 
Register 15: Address of entry point IKTAY82 


Ic entry point IKTAY83: 


Register 4: Address of TCAST 

Register 8: Address of TSB 

Register 11: Address of RMBPL 

Register 14: Address of return point in IEDAY8 

Register 15: Address of entry point IKTAY83 
Exit to: 


_— = ow ow = — == 


R/TM2: After entry at IKTAY81 
R/TM2: After entry at IKTAY&2 
IEDAY8: After entry at IKTAY83 


Register 15: Return code: 
0 Successful 


External References: IELAYTPC, POST aacro routine, STATUS macro routine 


— ee ee oe eee ee ee re ee a 


Ccntrol Blocks Used: ASCB, CVT, PSA, RMPL, SCVT, SRB, TCAST, TCX, 


eee ee ee ee ee ee ee ee i 


TIOCRPT, TSB, TSBX, TVCS, WSAVT 


Mapping Macros Used: CVT, IHAASCB, IHAPSA, IHARMPL, IHASCVT, IHASRB, 
IHAWSAVT, IKJTIOCP, IKJISB, IKTTCAST, IKTTVCS, IKTTCXD 


Executable Macros Used: GETMAIN, FREEMAIN, LOAD, POST, PURGEDEQ, 


SETLOCK, SPOST 
Sodule Attributes: Reenterable 


Lock Dependency: None 


— oe we ee = oe —— 2 ee oe 


Atend Codes: None 


Tata Sets: None 


— ew ee ee ee ee ee ee ee oe ee ee ee ee ee oe ee ee a ee oe 


Assembly Module: IKTEXIT 
Crkject Module: IKTEXIT 
Alternate Entry: Ncne 
Load Module: IKTIONOO 


BC _Uiagram: 3.7 


Functicn: IKTEXIT frees work areas for the calling routines and frees 


the SREs used by either IKTOMICS or IKTOMLU2. 


Entry from: IMTIMIDS, IKTIMLU2, IKTOMIDS, IKTOMLU2 
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Register 1: contains a pointer to a list of parameters. 
These parameters are the return address, work area length 
and total TIN/TOM work area length. 


Exit tc: Caller 


Registers at_Exit: N/A 
t 


ernal References: POST macro routine, STATUS macro routine 


om ow oe © ow ee 6 oe oe Oe er oe oe oe oe OP ae 


Ccntrol Blocks Used: ASCB, CVT, FRRS, PSA, SBB, TSB, TSBX, TVWA 


Eing Macros Used: CVT, IHAASCB, ITHAFRRS, IHAPSA, IHASRB, IKJTSB, 


Executable Macros Used: FREEMAIN, SETFRR, SETLOCK 


a oe ee oe ow 8 ee 8 ee we ee ee eo ee ee oe 


Mcdule Attributes: Reenterable 


eo ee eee ee we ee ee ee ee oe a 


Leck Dependency: The local lock is held by the calling routine. 


—~ 467 ae a ow oe owe a > a i a 


ed 


IKIGETXT --_Installation-Written Ncnsupported Terminal Edit Routine 


Object Module: IKTGETXT 
Load Module: IGcCO09C 


Functicn: An installation must write this routine if it wants to use 

a terminal not supported by TSO/VTAM. IKTVTGET will call IKIGETXT 
instead of using the IBM-supplied code at statement label EDIT3I270 (for 
3270 terminals) or EDIT3767 (for 3767 and 3770 terminals) in IKTVTGET. 
IKTGETXT must scan the input data, edit it, and move the edited data 


frco the input gueuve to the TGET requester's data area. 


Entry from: IKTVTGET 


a a ee ee ee 0 ee ee ee ee ee oe ee 


Register 0: Address of extended save area (XSA) 
Register 1: Address of input queue manager parameter list (IPARSS) 
Reyister 13: Address of register save area (serialized by the local 


lock; IKTGETZT should not release the lock if the save 
area is used) 

Register 14: Return address 

Register 15: Entry peint address 


Exit to: IKTVTGET 


Registers at_Exit: Restore all registers to the values they had at 


-_——_ ee ae ee ee > et nt a ae ee a 


Module Attributes: Reenterable 


VTIOC Prograsp Organization 77 


IKTIDSX1_--_Installation-Written Output Edit Exit Routine for IBM 3270 
Terpinals 
Names: 


om a we oe 


Object Module: IKTIDSX1 
Load Module: IKTIOMO2 


Function: An installaticn may write this routine to perform 3270 cutput 
editing in place of or in addition to that performed by the IBM-supplied 
rcutine IKT32700. The IEFM-supplied routine scans data, edits it 
according to the TPUT operands specified (EDIT, ASIS, CONTROL, or 
FULLSCR), and moves the edited data from the output queue into the 


cutput RU (request unit). 


Entry from: IKT32700 


_— oo = oe ne ae oe 


Register 0: Address cf a farameter list containing: 


Address of output gueue manager parameter list (OPARMS) 
Address of editing flags (WRKFLGS) 

Address of RU buffer size (TOMBUFSZ) 

Address of next unused RU byte (TOMBFPTR) 

Address of amount of data in the RU (BUFCNT) 

Address of next unused data byte (QBUFPTR) 

Address of amount of data moved (MOVCNT) 

Address of index indicating amount of data moved (QDTA) 


Register 13: Address of register save area 
Register 14: Return address 
Register 15: Entry point address 


Exit to: IKT32700 


ee re ee ee ee 


Registers 0-14: Restore to the values they had at entry. 
Register 15: Return code: 
00 The IBM-supplied routine IKT32700 should perform editing. 


Data is still on the output queue. 

Nonzero The exit routine performed the entire edit operation; 
portions cf IKT32700 are bypassed. The data has been 
moved to the output RU. 


Mcdule Attributes: Reenterable 


ee ew ee eo ee eo 
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Crject Module: IKTIDSX2 
Load Module: IKTIOMO2 


Function: An installaticn may write this routine to perform input 
scanning and editing in addition to that performed by the IBH~supplied 
reutine IKT3270I. If previded, IKTIDSX2 is called after the data is 
translated (if necessary) fron ASCII code to EBCDIC but before it is 
scanned for input line delimiters, broken into line segments, and flaced 


cn the input queue. 
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Entry from: IKT32701 


Register 0: Address of the input data 
Register 1; Data length 

Register 13: Address of register save area 
Rejister 14: Return address 

Register 15: Entry point address 


Fxit tos IKT3270I 


Registers at_Exit: Restore all registers to the values they had at 


—_-_ > op or OD On a oe ow ae oe ee oe ao 


Mcdule Attributes: Reenterable 


em om om 6 Oe er oe oe 8 ee ee ee oe 
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-_ = we oe oe 


Object Module: IKTIDSX3 
Load Module: IKTIOMNO2 


Function: An installaticn say write this routine to handle attention 
interruptions from IBM 3270 LUO terminals during input editing instead 
cf using the IBM-supplied routine IKTATTN. One use of an 
installation-written attention handler might be to clear the queues 
ccnditionally (rather than unconditionally) when an attention 


interruption is received. 


Entry from: IKTIMIDS 


_ _ ee i ee ee ee oe ee oe oe ae 


Register 13: Address of register save area 
Register 14: Return address 
Register 15: Entry fcint address 


Fxit to: IKTIMIDS 


Registers at Exit: Restore all registers to the values they had at 


—- — a ae am ee ow ee om on on oe ae oe 


Mcdule Attributes: Reenterable 


Object MOdule: IKTICSX4 
Load Module: IGCCOQ9C 


Functicn: An installation may write this routine to perform 3270 
editing in place of or in addition to that performed by the I5M-supfplied 
code at statement label EFDIT3270 in module IKTVIGET. EDIT3270 scans 

fer invalid data and 3270 control characters and moves the data frca 

the input gueue to the TIGET reguester's data area. An installation 


Bight write an edit exit routine to change TGET EDIT editing criteria. 
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Reyister 0: Address of extended save area (XSA) 
Reyister 1: Address of input queue manager parameter list 
(IPARMS) 


Reyister 13: Address of register save area (serialized by 
the local lock; IKTIDSX4 should not release the 
lock if the save area is used) 

4: Return address 


Register : 
5: Entry feint address 


Register 


Exit to: IKTVTGET 


er ee ee ee oe oe 


— — ee we ea ai ee 


Reyisters 0-14: Restore to the values they had at entry. 
Register 15: Return ccde: 


00 The exit routine performed the entire exit oferaticn and 
moved the input data to the TGET data area. 

O4 The exit routine performed only a data scan; the IEM-supplied 
code (EDIT3270) should perform editing. 


Mcdule Attributes: Reenterable 


ee ee ee ee 


IKTIDS£5 -- Installation-Written Attention Handler for IBM 


— ee ee ee ee es se ee ee i ee ee oe ee ee ee eo a ee i ee ee ee ee ee ee oe ee ee 


— ee we we ae a ee ee ee a ee ee 


CrEject Module: IKTIDSX5 
Load Module: IKTICHO2 


Function: An installaticn may write this routine to handle attention 
interruptions from IBM 3270 LU2 terminals during output editing, instead 
cf using the IBM-supflied routine IKTATTN. An installation-written 
attention handler may be used, for example, to clear the queues 
ccnditionally (rather than unccnditionally) when an attenticn 


interruption is received. 


Entry from: IKTIMLU2 


_——_— eee ee ee ee eee ee ee ae 


Register 13: Address of save area 
Register 14; Return address 
Register 15: Entry point address 


Exit to: IKTIMLU2 
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Registers at Exit: Restcre all registers to the values they had at 
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Mcdule Attributes: Reenterable 
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IKTIICM --— TIM/TOM Initialization Routine 


Assembly Module: IKTIION 
Object Modules IKTIICS 
Alternate Entry Points: Nene 
Load Module: IKJEFLA 


unction: This routine initializes the terminal input panager SRB and 
he terminal output manager SRB. 


Entry from: IKTLTERM, IKTXINIT 


Reyister 13: Address of register save area 
Register 14: Return address 
Register 15: Entry feint address 


Fxit_ to: IKTLTERM, IKTXINIT 


Register 15: Return code: 


0 Success 
Nonzero Failure 


External References: None 


Ccntreol Blocks Used: ASCB, CVT, PSA, SCVT, SRB, TCAST, TSB, ISBX, TVWA 


Mapping Macros Used: CVI, IHAASCB, IHAPSA, IHASCVT, IHASRB, IKJTSB, 


IKTTCAST, IKTTVWA 


Executable Macros Used: fFREEMAIN, GETMAIN, MODESET, SCHEDULE, SETLOCK 


—- ab = oe ow oe Oo a 6 Oo oe OF 8 Ome ee ow oe oe 


Mcdule Attributes: Reenterable, privileged, key 0 


Leck Dependency: The local lock is held on entry. 


Akend Codes: None 


Cata Sets: None 
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Assembly Module: IKTIMIDS 
Okject Module: IKTIBICS 
Alternate Entry Points: Nene 
Lead Module: IKTIONOZ 


BHC_Tiagram: 3.1 


Functicn: This routine obtains (RECEIVE macro) data from VTAM buffers 


(fcr IBM 3270 LUO terminals) and places it on the input queue for 
Frocessing by the TGET routine. 
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m: IKTIIOM thrcugh dispatcher (that is, scheduled as a SRB 
M) to entry point IKTIMIDS: Normal 


Register 1: Address cf a work area 


ro ee epee 


Dispatcher: Normal 
IKTIOFRR: By way of R/T 


Register 15: Reason code 0103 (hex) if abend OAB occurred during 
IKTIMICDS execution 


Fxternal References: IKTATIN, IKTEXIT, IKTIDSX3, IKTIOFRR, IKTQMNIN, 


Ccntrol Blocks Used: ASCB, CVT, FRRS, PSA, RPL, SCVT, SDWA, SRB, TCAST, 


Mapeing Macros Used: CVT, IFGRPL, IHAASCB, IHAFRRS, IHAPSA, IHASCVT, 


IHASDWA, IHASRB, IHAWSAVT, IKJTSB, IKTEQU, IKTIPARM, I[KTOPARM, IKTTCAST, 
IKTTVWA, ISTUSFCB 


Executable Macros Used: ABENL, FREEMAIN, RECEIVE, SCHELULE, SETFRR, 
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SETLOCK 


Module Attributes: Reenterable 


Akend Codes: OQAB with reason code 0103 (hex) in register 15 (RECEIVE 
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Macro error) 


Lata Sets: None 


3270_LU2_ Terminal Input Manager 


Assembly Module: IKTIMLU2 
Okject Module: IKTIMLU2 
Alternate Entry Pcints: Ncne 
Load Module: IKTIOBO3 


MC_Ciagram: 3.5 


Function: This routine issues the VTAS RECEIVE macro, determines what 
the input is when the RECEIVE is satisfied, calls the afpropriate 
rcutine to process the input and loops back to reissue the RECEIVE. 
The RECEIVE may be satisfied with DATA, CANCEL, LUSTAT, SIGNAL, CLEAR 


cr seme kind of error ccndition. 


Entry from: Scheduler 
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Registers_at_Entry: 
Register 1: Address cf a work area 


Exit to: 


Branch Register 14: Normal 
IKTIOFRR: By way of R/TS 


Registers at_Exit: N/A 
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External References: IKTATIN, IKTEXIT, IKTIDSX5, IKTIOFRR, IKTQHIN, 


Control Blocks Used: ASCB, CVT, FRRS, PSA, RPL, SRB, TCAST, TIMWA, 
TSE, ISBX, TVWA 


Mapping Macros Used: CVI, IFGRPL, IFGRPLVT, IBAASCB, IHAFRRS, IHAPSA, 


IHASCVT, IHASRB, IHAWSAVT, IKJTSB, IKTEQU, IKTIPARH, IKTOPARH, IXKTTCAST, 


IKTTIMWA, IKTTVWA, ISTRPLFB, ISTUSFBC 


Executable Macros Used: ABENL, FREEMAIN, GETMAIN, RECEIVE, SCHEDULE, 


SEND, SETFRR, SETLOCK 


Mcdule Attributes: Reenterable 


Leck Dependency: Local lock is required to process incoming data 


Messages: None 


Akend Codes: OAB for no retry (103 reason code) 


Tata Sets: None 


Object Module: IKTINX2 
Load Module: IKJEFLA 


Functicn: An installation must write this routine if it wants to use 
installation-written terminal input managers and terminal output 
Managers. IKTINX2 should perform the same function for 
installation-written TIMs and TOMs that module IKTIIOM performs for 
the IBM-supplied TIMs and TOMs. IKTIIOM allocates storage for and 


initializes the TIM and TCM SREs. 


Entry from: IKTXINIT 
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Register 13: Address of register save area 
Register 14: Return address 
Register 15: Entry feint address 


Exit to: IKTXINIT 


Register 15: Return code: 


00 Successfal initialization 
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Nonzero Unsuccessful initialization 


Module Attributes: Reenterable 
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Assegbly Module: IKTIOFRR 
Object Module: IKTIOFRR 
Alternate Entry Points: None 
Lcad Module: IKTIOMNOO 


Functicn: This routine receives control from R/TM when a ncnrecoverable 
error has been encountered in the terminal input or output manager, 

when an ABEND has been issued ty the input or output manager, or when 
IKTIOFRR has been percolated to from another FRR. 


Entry from: R/TS 


Register 0: SDWA availability 
Register 1: SDWA address 
Exit to: 


Caller: Normal 
Register 15: Return code when SDWA is not available 
: None 
: ASCB, CVT, PSA, SDWA, SRB, TSB, TSBX, TVWA 


Used: CVT, IFAASCB, IFASRB, IHAPSA, IHASCVT, IHASDWA, 


Executable Macros Used: CALLATM, FREEMAIN, SETLOCK 


Cata Sets: None 
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Assembly Module: IKTISTOO 
Ckyjyect Module: IKTISTOO 
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Alternate Entry Points: Nene 
Load Module: IKTIOMCO 


NC_Ulagram: 3.12 


Functicn: This podule builds a UVECB for the lost terminal exit and 


Register 1: Address cf RPL 
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Register 15: Return code (in hex): 


Q UECB and VWRPL built, exit scheduled 
4 Storage not available for UECB and VRPL 


External References: None 
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Centrel Blocks Used: ISTACDEE, ISTATCVT, ISTPAB, ISTUECB, ISTMPST, 


oe oS > a ge oe oe oe Oe 8 om a a oe oe ee 


ISTLTCE, IFGACB, IFGEXLST, IHAFSA, IFGRPL, IHAASCB, ITHAASXB, IHASRB 


MNageing Macros Used: None 


Executable Macros Used: TPQUE, RELSTORE, REQSTORE 
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Mcdule Attributes: Reentrable 
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Lcck Lependency: This module is entered with the local lock held. 


Atend Codes: None 


TCata Sets: None 


Asseably Module: IKTLOGFF 
Chject Module: IKTLOGFF 
Alternate Entry Pcints: Nene 
Load Module: IKJEFLA 


Functicn: This routine disconnects (CLSDST macro) the user's terminal 
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frcm ISO and closes the user's ACB. 
Entry from: IKJEFLB 


Registers_at_ Entry: Irrelevant 
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FLB: Normal 
¢ Abend OAB 
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Registers at Exit: 


Register 15: Reason code 0203 (hex) if abend OAB occurred 
during IKTLOGFF execution 


Fxternal References: IKITOMJR 
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Control Blocks Used: ASCB, CVT, PSA, TCAST, TSE, TSBX, TVWA 


Bapping Macros Used: IHAASCB, IHAPSA, IKJTSB, IKTTCAST, IKITVWA 


Executable Macros Used: ABENL, CLSDST, EXECRPL, SETLOCK 


Ncdule Attributes: Reenterable 


Leck Defendency: None 


Aktend Codes: OAB with reason code 0203 (hex) in register 15 (cannot 


clcse ACB) 


Cata Sets: None 
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Assembly Module: IKTLOGR 
Crject Module: IKTLCGR 
Alternate Entry Pcints: Ncne 
Load Module: IKJEFLE 


MC _Ciagram: 1.3 
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Functicn: This routine establishes reconnection of a TSO/VTAM terminal 


to the address space from which it was disconnected. It is invoked 
when a logon command specifies the reconnect operand. 


Entry from: IKJEFLEA 


— — a oe ee on ee ee a oe oe ow a oe oa 


Register 1: Address cf parameter list containing user ID 
and password 


Exit to: IKJEFLEA 
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Register 15: Return ccde (in hex): 


00 Successful reccnnection 
O04 Invalid passwerd 

08 Invalid user IL 

OC Unsuccessful reconnection 


External References: IKTMSGS, IKTQMOUT 
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Ccntrcl Blocks Used: ASCB, CVT, PSA, TCAST, TSB, TSBX, TVWA 


Mapring Macros Used: CVI, IHAASCB, IHAPSA, IKJTSB, IKTOPARM, IKTTCAST, 


IKTTVWA 
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Fxecutable Macros Used: CLSDST, EXECRPL, POST, SCHEDULE, SETLOCK 
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Module Attributes: Reenterable, privileged, key 0 


Lcck CLependency: None 


Oe _ we oe ae ao oe 


Arend Codes: None 


Tata Sets: None 
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Assembly Module: IKTLTERM 
Ckject Module: IKTLTERMS 
Alternate Entry Points: Ncne 
Load Module: IKTLTERM 


MC [Ciagram: 1.5 
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Functicn: This routine frocesses VTAM USS logoff requests, and handles 


certain VTAM transwissicn errors, for TSO/VTAM time-sharing. 


Entry from: Dispatcher (that is, scheduled as an IRE by VTAB) 


Register 1: Address cf a farameter list containing: 


Word 1: Address cf the terminal's ACB 

Word 2: Cospunications identifier (CID) of the tersinal 

Word 3: TSB address frcps node initialization block (NIB) user 
field 

Word 4: Code indicating reason for entering this routine 


Fxit to: 


Cispatcher: Normal 
R/TM: Abend QAB 


Register 15: Reason code 0105 (hex) if abend OAB occurred 
during IKTLTERM execution. 


External References: IKTIIOM, IKTINX2, IKTMSGS, IKTQMIN, IKTQMOUT 


Control Blocks Used: ASCB, CSCB, CVT, ECB, NIB, PSA, RPL, SCVT, SRB, 


ICAST, TCB, TSB, TSBX, TVWA 


Napping Macros Used: CVI, ITEECHAIN, IFGRPL, IFGRPLVT, IHAASCB, IHAECB, 
IHAPSA, IHASCVT, IHASRB, IKJTCEB, IKJTSB, IKTEQU, IKTIPARM, IKTOPARM, 
IKIICAST, IKTTVWA, ISTNIE, ISTRPLFB 


Executable Macros Used: ABENL, CLSDST, EXECRPL, FREEMAIN, GETMAIN, 
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MCCESET, OPNDST, SCHEDULE, SETLOCK, STIMER, TTIMER, WAIT, WTO 


Mcdule Attributes: Reenterable, privileged, key 0 
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LIcck_ Dependency: None 


Ressages: IKTI00I, IKT101I, IKT1IO2I, IKT103I, IKT1IO71I, IKTOOI3OOI 
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Akend Codes: OAB with reason code 0105 (hex) in register 15 (Bind 


failure) 


[Tata Sets: None 


ee a am a ee ao ae a ap 


ee ed 


Assembly Module: IKTMSGS 
Okject Module: IKTMSGS 
Alternate Entry Pcints: None 
Lcad Module: IKTMSGS 


MC CLiagram: None 


—_ oF oe oe ow oe —_ = -ae 


Functicn: This module contains VTIOC message texts. VTIOC sodules 


that issue messages obtain the address of IKTMSGS froma TCASHSGS and 
use the message number as an offset to obtain the text. 
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Registers at Entry: N/A 
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Registers at Exit: W/A 


External References: None 


Ccntrol Blocks Used: Nene 


Executable Macros Used: None 
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Mcdule Attributes: Not executable 


Lock Dependency: None 


Fata Sets: None 


IKIOMICTS --_ 3270 LUO Terminal] Cutput MNanager 


Assegbly Module: IKTCMIDS 
Chject Module: IKTOMIDS 
Alternate Entry Pcints: YWcne 
Load Module: IKTIONQO2 


MC_Diagram: 3.2 
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Function: This routine takes, from the output queue, output processed 


ty the TPUT routine, and sends it to a VTAM buffer for transmission to 
an IBM 3270 LUO terminal. 


Entry from: IKTIMIDS, IKTLTERM, IKTVTGET, IKTVIPUT, IKTXMTPT, IKTO94OC, 


IKTOONOE, IKTO9401, or IKTO94O9 through dispatcher (that is, scheduled 
as a SRB) 
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CLispatcher: Normal 
IKTIOFRR: By way of R/T 


Register 15: Reason code 0104 (hex) if abend OAB occurred during 
IKTCMIDS execution 


Fxternal References: IKTEXIT, IKTIOFPRR, IKTQMOUT, IKT32700 
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Ccntrol Bliccks Used: ASCB, CVT, FRRS, PSA, RPL, SCVT, SDWA, SRB, TCAST, 


ISB, TSEX, TVWA, WSAVT 


Napping Macros Used: CVT, IFGRPL, IHAASCB, IHAFRRS, IHAPSA, IHASCYT, 
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Executable Macros Used: ABEND, PREEMAIN, SEND, SETFRR, SETLOCK, STATUS, 
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SYSEVENT 


Module Attributes: Reenterable 
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Lock Dependency: None 


Messages: IKTOO4O00I (issued), IKTOOQUOST 


Atend Codes: OAB with reason code 0104 (hex) in register 15 (SEND 
Bacrce error) 


Tata Sets: None 


IKTCSLU2 --_ 3270 LU2 Terminal Output Manager 
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Asseably Module: IKTOMLO2 
Ckject Module: IKTOMSLU2 
Alternate Entry: None 
Lead Module: IKTIOMNO3 


HC _Ciagram: 43.6 
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Functicn: To send messages and controls to 3270 LU2 terminals. 
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Registers at Entry: 


Register 1: Address cf work area 
Register 0: Address cf SRE 


Branch Register 14: Normal 
Abend to IKTIOFRR: By way of R/TH 


Registers at_Exit: N/A 


External References: IKTIOFRB, IKTQMOUT 


Ccntrol Blocks Used: aASCB, ASXB, FRRS, IFGRPL, ISTMPST, ISTPAB, PSA, 


RELCF60, SCVTSECT, SRB, TCAST, TSB, TSBX, TVWA 


Marping Macros: CVT, IFGRPL, IHAASCB, IHAFRRS, IHAPSA, IHASCVT, IKTEQU, 


IKTOPARM, IKTTCAST, IKTTCHWA, IKTTVWA 


Fxecutable Macros Used: ABENLC, FREEMAIN, RECEIVE, SEND, SETFRR, 
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SETLOCK, SYSEVENT 


Mcdule Attributes: Reenterable 
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Icck Derendency: Local lock sust be obtained upon entry 


Messages: None 


Atend Codes: AB with reason code 104 in register 15 


Tata Sets: None 


ow ae ee ee oe 
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Assembly Module: IKTCMIN 

Okject Module: IKTQMIN 

Alternate Entry Pcints: IKTQMOUT, IKTQMFR1, IKTQSEV, IKTQMFR2 
Load Module: IKTCMIN 


MC _ Ciagram: 4.1, 4.2 


Functicn: This routine adds, updates, and reroves input and output 


gueue elements. 


Entry from: IKIATIN, IKTIMIDS, IKTIMLU2, IKTLOGR, IKTLTERH, IKTOMIDS, 
IKTCMLU2, IKTTIMRT, IKTTOMRT, IKTVIGET, IKTVTPUT, IKTXSTPT, IKTO9401, 
IKT3270I, IKT32700, to cne of the following entry points: 


IKTICMIN: Input queue functions 
IKTCMOUT: Output gueve functions 


R/TM to one of the fcllowing entry points: 


IKTQMFR1: Functional] recovery to trap errors and retry the 
request 

IKTQMFR2: Functional recovery to trap errors and retry 
element verification 

IKTQMEV: Element verification during recovery 
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Ic entry point IKTQMIN: 

Register 1: Address cf parameter list IPARMS 
To entry point IKTQMOUT: 

Register 1: Address cf parameter list OPARMS 
Ic entry point IKTQMFR1: 

Register 1: Address of SDWA 
To entry point IKTQMFR2: 

Register 1: Address cf SDWA 
Ic entry Foint ILKTQMEV: 


Register 0: Address cf storage to be verified 
Register 1: Contents of register 0 on entry to ITEAVEQV3 


EFxit to: Caller 


After entry at IKTCNEV: 
Register 15: Return code: 


00 The storage location contains a queue element and can be 
referenced. 

04 The storage location contains a queue element and can be 
referenced, but the gueve element contains data not related 
to the queuing information. 

08 Either the storage lcecation cannot tLe referenced or it can 
be referenced ktut does not contain a queue element. 


External References: IEAVEQV3, STATUS macro routine 
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Ccntrol Blocks Used: ASCE, CVT, FRRS, PSA, QVPL, SCVT, SDWA, SRB, 


TCAST, TSB, TSBX, TVCS, TVWA 
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Fxecutable Macros Used: ABEND, BLECPOOL, FREECELL, FREEMAIN, GETCELL, 


GETMAIN, MODESET, SCHEDULE, SETFRR 


Mcdule Attributes: Reenterable, caller's key, supervisor state 


Lock CLependency: The local lock is held on entry. 


Sessages: IKTOOQMOOT, IKTOO4OI! 


Atend Codes: OAD (GETCELL/FREECELL macro error) 


Cata Sets: None 
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Assembly Module: IKTRPLiT 
Ckject Hodule:; IKTRPELXIT 
Alternate Entry Points: Ncne 
Load Module: IKJEFLA 


Functicn: This routine checks (CHECK macro) the status of the OPNDST 
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REL reguest issued in the VTICC initialization routine (IKTXINIT). 


Entry from: Dispatcher (that is, scheduled as an IRB by VTAM) 


Registers at Entry: Irrelevant 
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Exit to: Dispatcher 


Registers at Exit: Irrelevant 


External References: Ncne 


a ew ow ew ae en ow a a oe ae oe 


Ccntrol Blocks Used: ASCB, PSA, TSB, TSBX, TVWA 


Mapping Macros Used: IHAASCB, IHAPSA, IKJTSB, IKTTVWA 


a —— a ee ee a pe Se ee ee ee 


Executable Macros Used: CHECK, EXECRPL, MOLDESET, POST 
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Module Attributes: Reenterable 


a ee ee ee ce ee ee eh ee ee ee oe a ee 


Leck Dependency: None 
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Atend Codes: None 


Lata Sets: None 
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Object Module: IKTRTX1 
Load Module: IKTIOMO1 


Function: An installaticn may write this routine to perform 3767 or 
3770 output editing in place cf or in addition to that performed by 
the IBM-supplied code at statement labels EDITASIS and CNTRLOPT in 
mcdule IKTTOMRT. The IBM-suppflied code scans data, edits it according 
tc the TPUT Operands specified (EDIT, ASIS, or CONTROL), and moves the 
edited data from the outfut queue into the output RU (request unit). 


Entry,from: IKITOMRT 


Register Q: Address of a parameter list containing: 


e Address of outfut queue manager farameter list (OPARES) 
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Address of next unused RU byte (BYTECNHT) 

Address of next unused data byte (BUFPTR) 

Address of the RU (RD) 

Address of amount of printable characters (CHARCNT) 
Address of flags (BITVALUQ) 

Address of the TSB (ASCBTSB) (leftmost bit "on" indicates 
last item in this parameter list) 


Register 13: Address of register save area 
Register 14: Return address 
Register 15: Entry fFoint address 


Fxit to: IKTTOMRT 
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Reyisters 0-14: Restcre to the values they had at entry. 
Register 15: Return code: 


00 The IB4-supplied code should perform editing. Data is 
still on the output gueuve. 

Nonzero The exit routine performed the entire edit operation; 
the IBM-surflied code is pypassed. The data has been 
moved to the output RU. 


Mcdule Attributes: Reenterable 
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Object Module: IKTRTX2 
Load Module: IKTIOMO1 


scanning and editing in additicn to that performed by the IBM-supplied 
code near statement label DATA2 in module IKTTIMRT. If provided, 
IKTIRIX2 is called after the data is translated (if necessary) fron 
ASCII code to EBCDIC but before it is scanned for input line delimiters, 
Ercken into single lines, and flaced on the input queue. 


Functicn: An installaticn may write this routine to perform input 


Entry from: IKTTIMRT 


Se 


Register 0: Address of the input data 
Register 1: Data length 

Register 13: Address of register save area 
Register 14: Return address 

Register 15: Entry foint address 


Exit tc: IKTTIMRT 


P ; ; $ 
Registers at _Exit: Restcre all registers to the values they had at 


Module Attributes: Reenterable 
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Ckject Module: IKTRTX3 
Load Module: IKTIOMQ1 


Function: An installaticn may write this routine to handle attention 
interruptions from IBM 3767 or IBM 3770 terminals instead of using the 
IEM-supplied code at statement label ATTN in module IKTTIMRT., One use 
cf an installation-written attention handler might be to clear the 
guevues conditionally (rather than unconditionally) when an attenticn 


interruption is received. 


Entry from: IKITIMRT 


Reyister 13: Address cf register save area 
Register 14: Return address 
Register 15: Entry feint address 


Exit_to: IKTTIMNRT 
Registers at Exit: Restcre all fegisters to the values they had at 
entry. 


Mcdule Attributes: Reenterable 
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CrEject Module: IKTRTX4 
Load Module: IGcCCd009C 


Functicn: An installaticn may write this routine to perform 3767 or 
3770 editing in place of or in addition to that performed by the 
IEM-supplied code at statement label EDIT3767 in module IKTVTGET. 
ELI13?767 scans for invalid data and moves the data from the inpat gueue 
to the TGET requester's data area. An installation might write an edit 


exit routine to change TGET EDIT editing criteria. 


Entry from: IKIVTGET 


ee ee es ee ee ee ee ee ee 


Register 0: Address of extended save area (XSA) 
Rejister 1: Address of input gueue manager parameter list 
(IPARMS) 


Register 13: Address of register save area (Serialized by the 
local lcck; IKTRTX4 should not release the lock 
if the save area is used) 

Register 14: Return address 

Register 15: Entry feint address 


Exit tc: IKTVTGET 


S4 


Registers 0-14: Restcre to the values they had at entry. 
Register 15: Return code: 


0O The exit routine performed the entire edit operation and 
moved the input data to the TGET data area. 

04 The exit routine performed only a data scan; the IEM-supplied 
code (EDIT3767) should perfora editing. 


Module Attributes: Reenterable 


ee ee oe ee ee a ee ee ee ee 


—_— eo =e ow oe we ow ee oe oe ow ee oe ea oe oe ee a ee ee ee ee ee es ee ee ee =r <> wee ee ee ee ad 
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Assembly Module: IKTTIMRT 

Object Module: IKTTIMRT 
Alternate Entry Pcints: IKTIMFPRR 
Load Module: IKTIOMNO1 


BC_Ciagram: 3.3 


Functicn: This routine cbtains (RECEIVE macro) data from VIAM buffers 


(for IBM 3767 and IBM 3770 terminals) and places it on the input queue 
fcr fFrocessing by the TGET requester. 


Entry from: IKTIIOM through dispatcher (that is, scheduled as a SRB 


ky IKTIIOMN) to entry point IKITIMRT: Normal 


R/TM to entry point IKTIMFRR: Error 


_> = ee ee ee es ee ee eo oe 


Register 1: Address cf a werk area 


Fxit to: 


mo te oe ow ow oe 


Cispatcher: Normal 
IKTIMFRR: Error 


Reyister 15: Reason code 0101 (hex) if abend OAB 
occurred during IKTTIMRT execution 


External References: IKIQMIN, IKTQMOUT, IKTRTX2, IKTRTX3, PCST macro 


— <= ow we om a ow ae om oe oe ow ow os oe 


reutine, STATUS macrc routine 


Ccntrol Blocks Used: ASCB, CVT, FRRS, PSA, RPL, SCVT, SDWA, SRB, TCAST, 


a ae a ge gr a ee ee eee 


IHASDOWA, THASRB, IHAWSAVT, IKJISB, IKTEQU, IKTIPARM, IKTOPARM, IKTTCAST, 
IKITVWA, ISTOSFBC 


Executable Macros Used: ABENLC, CALLR/TM, FREEMAIN, RECEIVE, SETFRR, 


a a ae ee ee oe oe ee ow oe oe oe oe ee ee ee ee eee 


Mcdule Attributes: Reenterable 


Icck_ Dependency: None 
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Hessayes: IKTOO4O0I (detected), IKTOO4O2ZTI (detected) 


Atend Codes: OAB with reason code 0101 (kex) in register 15 (RECEIVE 


eee ee ie a 


macro error) 


Cata Sets: None 


ee we oe oe oe we oe oe 


ee eee ee ee re ce ee ee a ee ee a ee oe ee om oe wee 2 oe ee ee Se oe a ee ee ee 


Assembly Module: IKTICMJR 
Object Module: IKTTOMJR 
Alternate Entry Pcints: Ncne 
Load Module: IKTTOMJR 


MC _DLiagram: 3.2.1 


Functicn: This routine sends (SEND macro) a null RU when one of the 
terpinal output managers cannct send an RU because it is susfended. 
This happens after a TSOyVTAM user has been canceled by the 
system-initiated-cancellation routine, a conditional lcgoff has 
cccurred, or a cross-memory TPUT has been sent to a 3767, 3770, or 3270 
LU2 terminal. Sending a null RU causes VTAM to be dispatched, thus 
netifying VTAM that the user's address space 1S swapped in again so 


that the terminal output manayer can be dispatched. 
Entry from: IKTLOGFF, IKTLTERM, IKTXMTPT 


Registers at_ Entry: N/A 


ee ee ee ee ee 


-— ee we eo 


Registers at Exit: N/A 


—— ee ee a ee ww oe ee 


Fxternal References: Ncne 


ee ee ees ee ee i 


Ccntrcl Blocks Used: ASCE, CVI, NIB, PSA, RPL, TSB, TSBX, TVWA 


eee ee eee ee ee ee ee eee oe 


g_Macros Used: CVI, IFGRPL, IHAASCB, IHAPSA, IKJTSB, IKTTVWA, 


Executabtie Macros Used: FREEMAIN, GETMAIN, SEND, SETLOCK 


ee eee ee ee ee ee ee ee ee ee ee ee 


——_—— — ~— — 


Atend Codes: None 


ee ee eee ee we ee ee 


Lata Sets: None 


— ee ee eee ee ee 


ee ee ee ee ee a ae ee ge ae ee ee ee ee ee ee ee ee ee oe — ae ee ee ee ee — oa 


— 


Assembly Module: IKTICMRT 
Ckject Module: IKTTOMRT 
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Alternate Entry PointS: IKTOMFRR 
Lead Module: IKTIOMNO1 


MC Ciagram: 3.4 


_— — = =a on ow ou ae 


Functicn: This routine takes, from the output queue, output processed 


ty the TPUT routine, and sends it to a VTAM buffer for transmissicn to 
an IBM 3767 or IBM 3770 terminal. 


Entry from: IKTLTERM, IKTITIMRT, IKTVTPUT, IKTXMTPT, ILKTO9MOC, IKTOOSOE, 
IKT09401, or IKTO9409 through dispatcher (that is, scheduled as a SRB) 
to entry point IKTTOMRT: Noroal 


R/TM to entry point IKTCMFRR:; Error 


Register 1: Address cf a work area 


Dispatcher: Normal 
IKTOMFRR: ELror 


-_ -_ oe ee > es ee ee et a ew 2 oe 


Register 15: Reason code 0102 (hex) if abend OAB 
occurred during IKTTOMRT execution 


External References: IKTRTX1, IKTQMOUT, STATUS macro routine 


ee ee ee 


ASCB, CVT, FRRS, PSA, RPL, SCVT, SDWA, SRB, TCAST, 


Napping Macros Used: CVT, IFGRPL, IFGRPLVT, IHAASCB, IHAFRRS, IHAPSA, 


IHASCVT, IHASDWA, IHASRB, IHAWSAVT, IKJTSB, IKTEQU, IKTOPARM, IKTTCAST, 
IKTTVWA 


Executable Macros Used: ABEND, CALLR/TM, FREEMAIN, RECEIVE, RESETSR, 


—_ = oe oe gp oe oe ee ee we ep oe es et ee ee ee 


SEND, SESSIONC, SETFRR, SETLOCK, SYSEVENT 
Mcdule Attributes: Reenterable 


Lock Dependency: None 


— me ee ae aes oe = ee oe ee ee 


Messages: IKTOOMOO0OI (issued), IKTOONO2I (issued), IKTOO4O3ZI 


Akend Codes: OAB with reason code 0102 (hex) in register 15 (SEND, 


RECEIVE, or SESSIONC macro error) 


[ata Sets: None 


—_— — ow ee ee 2 2 ee ee ee oe ee ce ee ee ee ee ee ee oe 


Assembly Modules IKTVTIGET 
Object Module: IKTVTGET 
Alternate Entry Points: Ncne 
Load Module: IGCQOOO9SC 
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Function: This routine handles TSO/VTAM TGET requests. It takes data 


ae ee OP oe et oe oe 


frcem the input gueue, edits it, and places it in the TGET requester's 
ruffer. 


Entry from: IGCOQO9C 


Register 3: Address cf CVI 
Register 4: Address cf TCE 
Register 5: Address cf SVRE 
Register 8: Address cf ASCE 
Register 9: Address cf TSE 


Exit to: Caller (SVC exit) 


— ep ee ee ee oe 


_— <P eee ee ee ee ee ee ee ee ee 


Register 15: Return code (in hex): 


00 Successful. 

04 No input was available and TPUT NOWAIT was specified. 

08 An attenticn interruption occurred. The message was not 
received. 

OC The TGET requester's buffer was too small to hold the input 
line. 

14 The terminal was disconnected and could not be reached. 


External References: IKIGETXT, IKTIDSX4, IKTQMIN, IKTRTX4, STATUS 


ee ee eee ee eee ee es oes 


Ccntrcl Blocks Used: ASCB, ASXB, CYT, MPST, PSA, RB, SCVYT, SRB, TCAST, 
TCE, TCT, TSB, TSBX, TYWA, TXSA J 


Mapping Macros Used: CVI, IEEXSA, IEFTCT, IHAASCB, IHAASXB, IHAPSA, 


IHARE, IHASCVT, IHASRB, IKJRB, IKJTCB, IKJTSB, IKTIPARM, IKTTCAST, 
IKTTVWA, ISTPAB, ISTCYPAEB, ISTIMPST 


Executable Macros Used: MODESET, SCHEDULE, SETLOCK, STATUS, SYSEVENT 


ee ee we ee ee i ie oe ee 


Mcdule Attributes: Reenterable, privileged, enabled, key 0 


— 2 oe ee oe oe ee ee ee ee ee ee a ee 


Icck CLependency: This module is entered with the local lock held. 


— a ee ot ow oe oe a oot oe 


Tata Sets: None 


—— oe ee ee oe 


Assembly Module: IKTVTPUT 
Okject Module: IKTVTEUT 
Alternate Entry Points: Ncne 
Lead Module: IGcCCQ09C 
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BSC Ciagram: 2.2 


Function: This routine handles TSO/VTAMK TPUT without ASID requests. 


It takes data from the TEFUT reguester's buffer, edits it, and places 
it on the output queue. 


Entry froma: IGcQ009C 


Register 3: Address cf CVT 
Register 4; Address cf TCE 
Register 5: Address cf SVRE 
Register 8: Address of ASCB 
Register 9: Address cf TSE 


Fxit to: Caller (SVC exit) 


Register 15: Return code (in hex): 


00 Successful. 

04 A terminal outfut buffer was not available and TPUT NOWAIT 
was specified. 

08 An attention interruption occurred. The message was not 
sent. 

14 The terminal was disconnected and could not be reached. 


External References: IKTCMOUT, STATUS macro routine 


Ccntrol Blocks Used: ASCE, CVT, PSA, RB, SCVT, SRB, TCAST, TCH, TCT, 


ISE, ITS8X%, TVWA, XSA 


Napping Macros Used: CVT, IEEXSA, IEFTCT, IHAASCB, IHAPSA, IHARB, 
IHA 


SCVT, ILHASRB, IKJTCB, IKJTSB, IKTOPARM, IKTTCAST, IKITVWA 


Executable Macros Used: MODESET, SCHEDULE, SETLOCK, STATUS, SYSEVENT 


<> om er ee OP ee a oe ee ow ee = ee ee ge 


—- =P a ow aw — a 


Atend Codes: None 


a om oe Ob oe wo om a ee oe oe 


[Tata Sets: None 


Assembly Module: IKTXINIT 
Okject Module: IKTXINIT 
Alternate Entry Points: Nene 
Lcad Module: IKJEFLA 


SC Diagram: 1.1 


VTIOC Program Organization 99 


Function: This routine initializes VTAM control blocks and the TVWA, 


_— oe a ow oe eo 


address space. 


Entry from: IKJEFLA 


Registers _at_Entry: Irrelevant 


——_ a a oe ee ee a ee ee ee oe op oe 


Exit_to: 
IKJEFLA: Normal 
R/TM: ABEND OAB 


Registers at_Exit: 


Register 15: Return code: 


00 Successful initialization 
04 Unsuccessful initialization 


Cr reason code: 


0201 (hex) or 0202 (hex) if abend OAE occurred during IKTXINIT 
execution 


External References: BINDUSER (in IKTLTERM), IKTIIOM, IKTINX2, IKTRPLXT 


>: ACE, ACEYT, ASCB, CSCB, CVT, ECB, EXLST, EXLVT, 
NIE, ESA, RPL, TCAST, TCE, TSB, TSBX, TVWA, WESTD 


ee ee oe ee ee eee oe ee eee 


ITHAASCB, IHAECB, IHAPSA, IKJTCB, IKJTSB, IKTIPARM, IKTOPARM, IKTTCAST, 
IKTTVWA, IKTWESTD, ISTNIEB, ISTRPLFB ) 


Executable Macros Used: ABENL, BLUCPOOL, EXECRPL, FREEMAIN, GETCELL, 


—— awe oe ee ee ee we oe ee ee ee ee ee ee oe oe 


GETMAIN, MODESET, OPNDST, POST, SETLOCK, WAIT, WTO 


Mcdule Attributes: Reenterable, privileged, key 0 


Leck DLependency: None 


a ew a we oe oe eee ee ae oo 


Messages: IKTIO4I, IKT105I, IKT1061 


>: QOAB with reascn code 0201 (hex) (invalid application ID) 
x) (cannot open ACE). 


Cata Sets: None 


— ow ee oe ae ee oe 


—— oe ee ee we ee ee ee ee ee ee es ee ee ee oe ee ee 


_— 2 ~~ 2 


Assembly Module: IKTXLOG 
Orject Module: IKXTLCG 
Alternate Entry Pcints: Ncne 
Load Module: IKJEFLE 


MC _Ciagram: 1.2 


Functicn: This routine sets up the address of the logon command buffer 


as a farameter for the LCGON Scheduling routines. 


100 


Entry from: IKJEFLE 


Register 1: Address cf a location in which the address of the 
logon buffer will be stored 


Exit tc: IKJEFLE 


oe ow oe ae ae 


—_ =~ on ee ee Se ee eS Pe eS eS ee 


Register 1: Address cf the address of a buffer containing the 
logon cosmand 


Fxternal References: Ncne 


Centrol Blocks Used: ASCB, PSA, TSB, TSBX, TVWA 


—_ oe Oe oe ow oe fe oe ee oe oe oe o> eo os a 


NafgEing Macros Used: IHAASCB, IHAPSA, IKJTSB, IKTTVWA 


—_ ow a ae ee ae a a ao oe 


Lata_sets: None 


Assembly Module: IKTXMTPT 

Object Module: IKTXMTFT 

Alternate Entry Points: IKTXMFRR 

Load Module: IGC0QQ9C 
NC_Ciagram: 2.3.1 


Functicn: This routine handles TSO/VTAM TPUT with ASIC requests for 
the target address space. It takes data from the TVCS and places it 
cn th 

Entry from: 


IKTASTPT through dispatcher (that is, scheduled as a SRB) to entry 
FCint IKTXMTPT: To fut message on queue and post source 


R/IM to entry point IKTXMFRR: To post source with notice that this 
address space is terminating 


Registers at_Entry: Irrelevant 


Cispatcher: After entry at IKTXMTPT 
R/TH&: After entry at IKTXMFRR 
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Registers at_Exit: 


_ — 


Register 14: Address of return point 


External References: IKTQMOUT, POST macro routine, SYSEVENT macro 


er ee cee et ee rer Oe ee re ee ee ee ee 


Ccntrol Blocks Used: ASCE, CVI, FRRS, PSA, SUWA, SRB, TCAST, TSB, 


— a a ew oe oe 0 ee ee i a ae ee oe 


TSEX, TVCS, TVWA, WSAVT 


Mapeing Macros Used: CVI, IHAASCB, IHAFRRS, THAPSA, IHASDWA, IHASRB, 


IHAWSAVT, IKJTSE, IKTEQU, IKTOPARM, IKTTCAST, IKTTVCS, IKTTVWA 


Executable Macros Used: FREEMAIN, SETFRR, SETLOCK 


eo oe ew eo ee ee oe ee eo eee a oe 


a we ee ee = oe oe oe b> a ate oe 


Atend Codes: Ncne 


ee te ee ee ee et 


Lata Sets: None 


2 a a ee ee oe oe ee 


IKTCOQO9D_-- Terminal Control Macro Branching 


—— <r ee ee oe eee ee ee ee owe eee ee ee a ee ee eg — [en —_, — 


_— a ee ee 


Assembly Module: IKTOOO9ID 
Ckject Module: IKTQQO0O9D 
Alternate Entry Fcints: Nene 
Load Module: IGCQ0Q09L 


MC Diagram: 5.1 


— = of @ on a= a oh oe 


Functicn: This routine checks the entry code received from IGCO009D. 


If the code is valid, it routes contro] to the appropriate terminal 
ccntrol macro nodule. 


Entry from: IGcooogr 


Register 0: Entry cede in high-order byte 
Reyister 1: Address cf parameter list 
Register 3: Address cf CVT 

Register 4: Address cf TCE 

Register 5: Address cf SVRE 

Register 8: Address cf TSE 


Exit tc: Caller (SVC exit) 


= sep > oe ow ee eee ee ee 


Register 14: Return address 
Register 15: Return code from terminal control macro module that 
was invoked. See OS/VS2 TSO Guide to Writing a 


a oe aes oe ae oe —_— oF ee ae =o oe amie Achar —_ o> a —_ oe aD ee ae ee ee ee ae Ser DS <n ee 


specific return codes. 
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- —= 


External References: Terminal control macro routines (see MO 5.1) 


Control Blocks Used: Ncne 


Mapping Macros Used: None 


Executable Macros Used: Nene 


a aD ee eee Se ee ee oe ee a ee ee ee oe a 


Module Attributes: Reentrant 


om ee ee ee ee ee ee ee ee ee oe 


Lock Dependency: This module is entered with the local lock held. 


—_——_ ap a = —_ 


Abend Codes: Ncne 


2 a es ee ee eee ee es 


Assembly Modules IKTO9S4OA 
Ckject Module: IKTO9S4OA 
Alternate Entry Points: Ncne 
Load Module: IGCCQC9L 


HC Diagram: 5.5 


_— 2 oe oo —_ 


Functicn: This routine services the STSIZE macro instruction for 
ISC/VTAM terminals. It sets values in the TSB, depending on the operand 
specified with STSIZE, tc indicate the logical line size and, if a 
display station, the number of lines on the screen. It sets a Switch 

in the TVWA so that the terminal output manager will check the screen 


size. 


-_—— oo a a ee ee ee ee ee ee oe a Oe ee 


Register 0: Number cf lines 

Register 1: Line size 

Register 5: Address of TSE 

Register 12: Entry foint address and address of IKTOSUOA's base 
Register 14; Return address 


Exit to: Caller (SVC exit) 


ewe on oF ow ee oe 


~ 


Register 14: Return address 
Register 15: Return code (in hex): 


00 Successful 

04 Invalid parameter 

08 Line size not specified, or number of lines not specified 
for display terminal 

OC Nonstandard screen size specified 


Fxternal References: Ncne 


+ ome ae a GE ee Sor ers ee ee pe tee ie ae oe 
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Centro] Blocks Used: TSE, TVWA 


Mapping Macros Used: IKJTSB, IKTTVWA 


— ee oe ee ee ee os ee ep ee 


Fxecutable Macros Used: MODESET 


— a OP ee a ee Oe oe oe ow ae oe wen ee ae oe 


Mcdule Attributes: Reenterable 


Lock Dependency: This module is entered with the local lock held. 


ee ee ee ae ee 
—_—— a oe —— 


ee ee ee we oe es eee oe 


Cata Sets: None 


mee ee ce ee ee ce ee ee oe 


—_— a owe 


Assembly Module: IKTQ94O0C 
Object Module: IKTOS94OC 
Alternate Entry points: Ncne 
Load Module: IGCCOQOSL 


MC Diagram: 5.6 


Functicn: This routine services the STAUTOCP macro instruction for 


ISC/VTAM terminals. It sets values in the TSB to start automatic 
character prompting. 


Entry from: IGcCOO009DL 


Register 1: Zero 

Register 5; Address of TSE 

Register 10: Address of ccnstants 

Register 12: Entry point address and address of IKTO94OC's base 
Register 14: Return address 


Exit to: Caller (SVC exit) 


we ae ee oe oe oe 


Register 14: Return address 
Register 15: Return cede: 


00 Successful. 
O4 A farampeter was specified in register 1 but none was expected. 


External References: None 


ee ee ee ee ee ee ee ee oe 


Centre] Blocks Used: CVT, PSA, SRB, TSB, TSBX, TVWA 


Marffing Macros Used: CVT, IHAPSA, IHASRB, IKJTSB, IKTTVWA 


Fxecutable Macros Used: SCHEDULE 


ee ce ee ie ee ee oe eee ee eee ee ee ee 


Module Attributes: Reenterable 


om ap oe ow OS = om a oe eo on oe oe oe ae 


Lock Dependency: This module is entered with the local lock held. 


Arend Codes: None 


ee er a ae oe om a = ow oe 


Lata Sets: None 


ee ee ee ee es ee ee ee > ee oe Ss > ie ee ee oe i Oo oe a es eae 


Assembly Module: IKTO94ODP 
Crject Bodule: IKTO94OD 
Alternate Entry Points: Necne 
Load Module: IGCOQQ09L 


iC_Eiagram: 5.7 


Function: This routine services the SPAUTOPT macro instruction for 


ISC/VTAM terminals. It sets values in the TSB to stop automatic line 
nugkering or automatic character proapting. 


Entry_from: IGcoo0ogpD 


Register 1: Zero 

Register 5; Address of TSE 

Register 12: Entry fcint address and address of IKTO94OD's base 
Register 14: Return address 


Exit to: Caller (SVC exit) 


Return address 
Return code: 


Register 14 
Register 15 


00 Successful. 

CH A Parameter was specified in register 1 but none was expected. 

08 Neither line numbering nor character prompting was in use. 
External References: Ncne 


2 om Oe ee ee oe ae ep a ee ee es oe 


Ccntrcol Blocks Used: TSE 


> ae ate eet we ate oe eer es a> ee ee ee et ce ee a ee ee 


MNafring Macros Used: IKJTSB 


oe ee ee et oe ee ee es ee ee ee ae 


— =e a ae ee a —_ << =a a ow 


[ata Sets: None 
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Assembly Module: IKTOS4OE 
CkEject Module: IKTO94OE 
Alternate Entry Points: Nene 
Load Module: IGCQOOQ9L 


Functicn: This routine services the RTAUTOPT macro instruction for 


ISC/VTAM terminals. It sets values in the TSB to restart automatic 
line numbering or automatic character prompting. 


Entry from: IGCcOQOogr 


waa ee ee oe ee oe oe oe a oe 


Register 1: Zero 

Register 5; Address of TSE 

Register 12: Entry foint address and address of IKTO9S4QE's base 
Register 14: Return address 


Exit to: Caller (SVC exit) 


ee 


—_—<—~ ee 


Register 14: Return address 
Register 15: Return code: 


00 Successful. 
04 A parameter was specified in register 1 but none was expecte 
08 Prompting was not in use. 


Fxternal References: Ncne 


—_ = ae ae ame ae we oe ow ee ae as oe oe _— 


Centro] Blocks Used: CVT, PSA, SRB, TSB, TSBX, TVWA 


Bapping Macros Used: CVT, IHAESA, IHASRB, IKJTSB, IKTTVWA 


Executable Macros Used: SCHELDULE 


ee ee ee ee ee ee ee ee ee ee es ee ow oe 


Module Attributes: Reenterable 


ee ee ee ee ee eee ee ee oe oe ee 


Lock _Lependency: This mcdule is entered with the local lock held. 


Akend Codes: None 


oe ee ee ee ee ee ee 


[Tata Sets: None 


7 me ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee es es ee en es ee 


Assembly Module: IKTCO94OF 
Crject Module: IKTO94OF 
Alternate Entry Points: NWone 
Load Module: IGCCOOQ9L 


BO Diagram: 5.9 


Function: This routine services the STTRAN macro instruction for 


ISC/VTAM terminals. It sets up, modifies, or discontinues the use of 
translation tables, depending on the operands specified with STTRAN. 


Entry from: IcGcodgogr 


—_——-_ ee ee a ee es ee ee eae 


Register 0: Indicators (one byte each): 


A Entry code - OF 
e Flags - bit 0 on = NOTRAN specified 
bit 1 cn = NCCHAR specified 
bit 2 on = TCHAR and SCHAR specified 
bd Terminal character (to be translated in the systen) 
° System character (to be translated at the terminal) 


Register 1: Address of a farameter list containing: 
Address of a fair cf user-written translation tables 
° Address of the name of the member containing user-written 
translaticn takles 
Register 5: Address of TSE 
Register 12: Entry foint address and address of IKTQ94OF's base 
Register 14: Return address 


Exit to: Caller (SVC exit) 


Return address 
Return code (in hex): 


Register 14 
Register 15 


00 Successful. 

04 NOTRAN or NOCHAR was specified but translaticn was not in 
effect. 

08 TABLE or NOCHAR was specified but an address was not provided 
with the NAME cperand. 

OC Internal error - an unidentifiable flag was set in input 
register 0. 


External References: None 
Ccntrel Blocks Used: CVT, PSA, TSB, TSBX, TVWA 


— eee ae ee oe oe ee er oe es ee ee 


Fapfring Macros Used: CVT, IHAPSA, IKJTSB, IKTTVWA 


2 Pe ee ee ee es 


Fxecutable Macros Used: FREEMAIN, GETMAIN 


— oe a on Oe ee eee = 6 ee ee oe ee a oe oe 


ee oe ee ee oe —— ny qmne alee Se omer 


Abend Codes: None 


Data Sets: None 
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IK109401_-- TCLEARG Terminal Control Macro Routine 


Ce ineliinn almetiionaed 


Assembly Module: IKTQ9401 
Crject Module: IKTO9401 
Alternate Entry Pcints: Ncne 
Load Module: IGCQQOQ9L 


BC _Viagram: 5.1 


Function: This routine services the TCLEARQ macro instructicn for 


ISC/VTAM terminals. TCLEARQ clears input and output message gueues. 


Entry from: IGCcO0009D 


— ee ee eo 


Register 1: Indicator: 


00 Clear output gueve cf all but ASID messages. 
<0 Clear input queue. 


Register 5: Address of TSE 
Register 12: Entry feint address and address of IKTO9401's base 
Register 14: Return address 


Exit te: Caller (SVC exit) 


— om ge oes oe 


—_—_ me eee ee ee ee ee ee ee ee ee ee 


Registers at Exit: 


Register 14: Return address 
Register 15: Return code: 


00 Successful. 
O4 Register 1 at entry contained a value greater than zero. 


External References: IKICMIN, IKTQMOUT 


SS ee 


Ccntrol Blocks Used: CVT, PSA, SRE, TSB, TSBX, TCAST, TVWA 


ee ee cee ee ee ee ee ee ee ee ee 


Happing Macros Used: CVI, IHAPSA, IHASRB, IKJTSB, IKTEQU, IKTIPARM, 


——_ ge ne ie ee ee ee 


IKTOPARM, IKTTCAST, IKTTVWA 


Executable Macros Used: SCHEDULE 


— ee ee ee a ae ee ee ee ee ee en ee ee oe 


NBodule Attributes: Reenterable 


— we eee ee ee ee ee ee oe ee re oe 


Lock Dependency: This mcudle is entered with the local lock held. 


— ee we oe — 


“Akend Codes: None 


ee ce ee ee ee ee 


Tata Sets: None 


—— ee ee ee ee ee ee 
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Asseably Module: IKTC9404 
Object Module: IKTO9404 
Alternate Entry Points: Ncne 
Load Module: IGCOQOQ9L 


NC_Ulagram: 5.2 


— 


Functicn: This routine services the STBREAK wacro instruction for 
ISC/VIAM terminals. It sets a bit in the TSB, depending on the operand 
specified with STBREAK, to indicate whether TSO is allowed to interrupt 


input transa@ission. 


Entry from: IGCOQO9L 


Reyister 1: Flag (left-most bit): 


Cn = STBREAK NO 
Cff = STBREAK YES 


Register 5: Address of TSE 
Register 12: Entry foint address and address of IKTO94Q04's base 
Register 14: Return address 


Exit to: Caller (SVC exit) 


Bejister 1 


4: Return address 
Register 15; 


Return code: 


00 Successful. ae 
04 Register 1 at entry contained a nonzero value in bits 1-31. 
08 STBREAK was issued for a 3270 terminal. 


— 


External References: Nene 


Ccntrcl Blecks Used: CVT, PSA, TCAST, TSB, TSBX 


— a 2 ae ow oe OP oe eo om oe oe om oF a On oe eo 


Mapping Macros Used: IHECVT, IHAPSA, IKJTSB, IKTTCAST 


—_ a —ea en =p om ew eo a oe ee 


Fxecutakbkle Macrcs Used: MODESET 


_— oe a sce a om ae © ee oe oe ee ee ee oe oe oe 


Mcdule Attributes: Reenterable 


2 ome ee ee ee oe oe ee ee eo oe Ow oe a oe 


Lock Dependency: This module is entered with the local lock held. 


_ we aw we oe == ae on oo 


Atend Codes: None 


LCata Sets: None 
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— -— a oe om 


Assembly Module: IKTO9405 
Object Module: IKTQ94O05 
Alternate Entry Pcints: Nene 
Load Module: IGCQQO9L 


BC _ [Tiagram: 5.3 


Functicn: This routine services the STCOM macro instruction for 


=e a ne ae ee at oP eee 


TSO/VTAM terminals. It sets a bit in the TSB, depending on the operand 
specified with STCOM, to indicate whether a terminal is allowed to 
accert messages from other terpfinals. 


Entry from: IGCQO09D 


Register 1: Flag (left-most bit): 


On = STCOM YES 
Off = STCCM NO 


Register 5; Address of TSE 
Reyister 12: Entry fFoint address and address of IKTO9405's base 
Register 14: Return address 


Fxit tc: Caller (SVC exit) 


Register 14; Return address 
Reyister 15: Return code: 


00 Successful 
04 Input parameter error 


External References: Ncne 


Ccntrcl Blocks Used: MTSE 


Napping Macros_Used: IKJTSB 


a —_— ee ee ee oe a ee oe 


Fxecutable Macros Used: MODESET 


a ser a ee ee nee ee ee ee a oe OP Oe ee ee ee ap oe 


Lock Dependency: This module is entered with the local lock held. 


Messages: None 


— aw a oe oe = —_ 


Aktend Codes: None 


—_— a oe ee ee ee 


[Tata Sets: None 


ee ees we we 


-_— = on =a oF 


Assembly Module: IKtT09409 
Object Module: IKTO94Q9 
Alternate Entry Pcints: Nene 
Load Module: IGCQOQOQ9L 


BC_Diagram: 5.4 


Functicn: This routine services the STAUTOLN macro instruction for 
TSO/VTAM terminals. It sets values in the TSB, depending on the 
cperands specified with SIAUTCLNH, that are used in providing automatic 


line numbering. 


Entry from: IGCOQOO9D 


—_ —_ =e aw > an em ae Oe oe a ao 


Reyister 0: Address of start value 

Register 1: Address of increment value 

Register 5: Address of TSE 

Register 10: Address of SVC 94 constants 

Register 12: Entry fceint address and address of IKT0O9409's base 
Register 14: Return address 


Exit tc: Caller (SVC exit) 


= - ae oe ao oe ae a ow on om a we 


Register 14: Return address 
Register 15: Return code: 


CO Successful. 
C4 Start or increment value not within allowable limits | 
(0-99,999,999). 
External References: None 
Ccntrol_ Blocks Used: CVT, PSA, SRB, TSB, TSBX, TVWA 
MafEing Macros Used: CVT, LHAPSA, IHASRB, IKJTSB, IKTTVWA 


Executable Macros Used: SCHEDULE 


> a oe ge ae oe oe ee oe 
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Assembly Module: IKTO9412 
Object Module: IKT0O9412 
Alternate Entry Pcints: Ncne 
Load Module: IGCCOOQ9L 


MC _Ciagram; 5.10 


Functicn: This routine services the STFSMODE macro instruction for 
ISC/VTAM terminals. It sets bits in the TVWA, depending on the operands 
specified with STFSMODE, to indicate whether an IBM 3270 display 
terminal is to operate in full screen mode, whether this is the first 
time during execution of a command processor that full screen node has 
keen entered, and to indicate which program function (PF) key (if any) 


is to be used as the reshow key. 


Entry from: IGCQQO9L 


—w oe — a owe ge 


— —— me ee ee oe ee ee ee ee oe 


Register 1: 
Flag Bit 0: Bit 1: Bits 24-31: 


On = STFSMODE cn On = Initial call RSHWKEY value 
Off = STFSMODE off Off = Not initial 


Reyister 5: Address cf TSE 
Register 12: Entry pfecint address and address of IKTO9412's base 
Register 14: Return address 


Fxit_ to: Caller (SVC exit) 


— a ee ee ee 


—_ ee cine ee ee ee ee ee 


Register 14: Return address 
Register 15: Return code: 


00 Successful. 

04 Invalid parameter specified to the SVC. 

08 Invalid terminal type. This macro instruction is valid only 
for ITEM 3270 display terminals that use TSO/VTAA. 


External References: Ncne 


Centro] Blocks Used: MTSE, TSEX, TVWA 


Oe ee ee ee ee pee eee ee ee ee ee ee ee ee ee 


Bapping Macros_Used: IKJTSB, IKTTVWA 


_——-_ ae ae ee ee oe ee ee oe 


Executable Macros Used: None 


ee me ee ee ee ee ce ee ee ee ee ee oe 


Scdule Attributes: Reenterable 


— = ow er ee ow a ee ow a ee ee ee oe oe 


Lock Dependency: This module is entered with the local lock held. 


— ee ee —e = oe ee 


eee ee ee ee eee 
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1K109413 -- STLINENO Te 


oF a a oe oe ew ee ee oe ow ee ee ee ee eee 


(et 
te 
the. 
Is 
re) 
i 


Rages: 


Assembly Module: IKT09413 
Cirject Module: IKT09413 
Alternate Entry Points: Ncne 
Lcad Module: IGCQQOS9L 


NC Ciagram: 5.11 


Functicn: This routine services the STLINENO macro instruction for 
1SO/VIAM terminals. It sets values in the TVWA for IBM 3270 display 
terminals, according to the oferands specified with STLINENO: it sets 
the number of the screen line cn which the next non-full-screen message 
should appear, and it indicates whether the terminal is to operate in 
full screen node. 
Entry from: IGCOOO9D 


-— - a oe oe oP 68S ee ow 2 ee oe 


Register 1: Indicators (one byte each): 
e Flag (left-most bit): 


On = MODE=CN 
Off = MOLE=CFF 


e Reserved 
e Reserved 


e Screen line number that specifies where the next 
non-full-screen message should appear 


Register 5: Address of TSE 
Reyister 12: Entry fcint address and address of IKT09413's kLase 
Register 14: Return address 


Exit te: Caller (SVC exit) 


-_> ee ES OD eee abe ep ees ee ee ee ee 


Register 14: Return address 
Register 15: Return code: 


00 Successful. 

04 Invalid parameter specified to the SVC. 

08 Invalid terminal type. This macro instruction is valid only 
for IBM 3270 display terminals that use TSO/VTAH. 

OC The line number specified was 0 or it was greater than the 
baximum number of lines allowed for the terminal in use. 


Fxternal References: None 


we eee ey ee ee ee ee ee a 


Centrol_ Blocks Used: TSE, TSEX, TVWA 


Bafping Macros Used: IKJTSE, IKTTVWA 


Executable Macros Used: None 
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Mcdule Attributes: Reenterable 


Leck Dependency: This module is entered with the local lock held. 


.— oe oe oe oe oe —_— =e oe oe ee ee 
a oe a -——_ 


Tata Sets: None 


ee a ee we ee ee ee ee ee ee ee et cee ee ee ee ee ee ee es ee ee ee ee oe 


Assembly Module: IKTO9414 
Object Module: IKT09414 
Alternate Entry Pcints: Ncne 
Load Module: IGCQOQOQ9r 


MC Diagram: 5.12 


ee — re am 


Functicn: This routine frocesses the STTMPSD macro for a TSO/VTAM 
display terminal. STITMPMCD is issued by an application program that 
wishes to control all the messages that will be sent to or received 
frcm the terminal. The KEYS sode can be set on or off to indicate if 
the application wants the Attention and Clear keys passed to it as 


data. 


—_— ee ee ee ee ee ee ee ee ee 


Register 1 7 Bit 0 CN - for MODE ‘ON® 
OFF - for MODE "OFF! 
= Bit 1 CN - for KEYS=ALL 
OFF - for KEYS=NO 
Register 5 a Address of TSB 
Register 12 = Base address of IKTO9414 


Register 14 Return address 


Fxit to: Caller (SVC exit) 


— ee ee eo 


—_ = ee ee ee ee ee eo 


Register 14: Return address 
Register 15: Return code; 


C0 Successful. 
04 Invalid parameter specified to the SVC. 
08 Invalid terminal type. This is not a display terminal. 


External References: Ncne 


— ee me ee ee ee ee ee ee ee ee we 


Centrol Blocks Used: MTSE 


Ce eee 


Eapping Macros Used: Ncne 


a a oP a ae ae oe oe a 


114 


ee ee oe ee ee ee i ee ee 
ee me Pe ee ee es ee ee 


Atend Ccdes: None 


Te ee 


Tata Sets: None 


Assembly Module: IKT3270I 
Chject Module: IKT3270I1 
Alternate Entry Pcints: Nene 
Load Module: IKTIONO2 


BC_Liagram: 3.9 


Functicn: This routine checks the data received and if applicable, 


—_— = a qe oe os 


Flaces the data on the infut queue for processing by the correct TSO 
command processor. 


Entry from: IKTIMIDS or IKTIMLU2 


—-— == ap a —_— a ow eee 
—_ —- = OO ce ae ee we oe we eo 


Registers_at_Exit: N/A 


External References: IKTASCII, IKTIDSX2, IKTCMIN 


—_ << oe oe ee om om OP <e O = O ae Oe oe oe oe 


Ccntrol Blocks Used: ASCB, CVT, IFGRPL, PSA, RPL, SCVTSECT, TCAST, 


> ae we wen ee eee ee ee ee ee 


TIMWA, TSB, TVWA, KSAVT 


Baprping Macros Used: CVI, IFGRPL, IFGRPLVT, IHAASCB, IHAPSA, IHASCVT, 


—_ —_ PO ee a a ee ee owe ee 


IHAWSAVT, IKJTSB, IKTEQU, IKTIPARM, IKTOPARM IKTTCAST, IKTTIAWA, 
IKTTVWA, ISTRPLFB 


Fxecutable Macros Used: None 


om age ee as om Om oe ee oe oe Oe ee ot ee oe ee 


Module Attributes: Reenterable 


2 ap om ow Oe oe Oo oe ee we OP oe oe oe oe 
ewe oe oe —_ = = ae On 
— = a oe a 4 


Atend Codes: None 


Lata Sets: None 


— ow oe ow = oe ow oe 
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<a ene ee ope ee see ee ee ee ee ee ee ee ee ee oe oe ee ee ee ee ee ee ee oe em oe ee ee 


we ow oe oe 


Assembly Module: IKT32700 
Object Module: IKkT32700 
Alternate Entry Pcints: Ncne 
Load Module: IKTIOMO2 


MC_Diagram: 3.19 


Functicn: This routine edits messages and controls for 3270 terminals. 


el 


Editing depends on screen size and mode of data being processed. 


Entry from: IKTOMIDS or IKTOMLU2 


~ = — a ee ee ee ee te ee ee oe oe oe oe 


Register 13: Address of save area 


Fxit to: Caller 


a on ee ee oe oe 


Registers at_Exit: N/A 


—_— eee ete ee ee ee ee ee ce ee ee ee ee 


Fxternal References: IKTASCII, IKTIDSX1, IKTSSGS, IKTQMNOUT 


ee ee ee ee ee pe ee ee ee ee 


Ccntrol Blocks Used: ASCE, CVI, PSA, RPL, TCAST, TOMWA, TSB, TVWA 


a ee ee ee ee ae ee ee ee ee ees ee oe ae 


IKAPSA, IKJTSB, IKTEQU, 
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— a ee eo a ee ee ee eee ee ee ee ee ee oe 


— a aw aw oe oe = ae ae oe oe 


Atend Codes: None 


Cata Sets: None 


ee a ce cm ae ee tee ce ep ee ee ee ee re ee ee es eee ee ee om ee ae ee oe oe 


eee ee oe 


Assembly Module: IKT93EST 
Okject Module: IKT9IEST 
Alternate Entry Points: Nene 
Load Module: IGc0Q09C 


FC Diagram: 2.4 


_—— a 


Functicn: This routine handles abends encountered while processing 


ISC/VTIAM TGCET and TPUT requests. 


Entry_from: k/T# 


__ 92 ap om a ee ee Oe ee ee oe oe 


Register 1: Address of SIWA (if register 0 does not contain 
hex C) 

Register 13: Address of register save area 

Register 14: Address of return point 


Exit to: R/TM 


— ne 2 ee ee oe a 


Register 15: Return code: 
00 Continue with termination. 


External References: None 


= ee ae a ee a oe Oa ao > a a ee ae 


Ccntrol Blocks Used: ASCB, ASVT, CVT, PSA, RE, SCVT, SDWA, SRB, TSB, 


ISEX, TVCS, WSAVT, XSA 


Napping Macros Used: CVT, IEEXSA, IHAASCB, IHAASVT, IHAPSA, IHARB, 
IBARSB, IKJTSB, IKTTVCS, IHASCVT, IHASDWA, IHAWSAVT 


Executable Macros Used: CEQ, FREEMAIN, SETLOCK, SPOST 


a a oie a Oy a ee a a ae a eee ae 


Hodule Attributes: Reenterable, privileged, enakled, key 0 


Lock Dependency: The local lock is obtained to reference the TSB in 
the local address space. The SALLOC lock is obtained to branch enter 
the FREEMAIN macro rcutine. 


Akend Codes: None 


Lata Sets: None 
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s) 


ol 


__ aw oe A > a a a a a a 


Thais section shows the relaticnship between VTIOC load nodule nanzes, 
ckject module names, alternate entry point names, and assembly module 
nanes. It also shows which HIFO diagram (in "YTIOC Method of 
Cperation") and program organization description (in "VTIOC Program 
Crganization") is associated with each nape. 


There are four columns: 


e Nape - VTIOC names and their relationships to each other. Load 
module names appear farthest to the left. Indented under each load 
module name are the names of the object modules, alternate entry 
Foints, and assembly modules contained in the load module. 
VTIOC-only names have the frefix IKT; names having other prefixes 
are shared by VTICC and other time-sharing components. 


e Type - The type of name: load nodule, object nodule, alternate 
entry point, or assembly module. Names used in mcre than cne way 
have more than one tyfe. 


e MO Liagram - The identification number of the HIPO diagram (in "VTIOC 
Method cf Operation") in which the function corresponding to each 
name is described. 


e FO Name —- The name of the routine in “VTIOC Program Organization" 
that corresponds to each name in column one. 


Se pe ee gta yb og NE” CASTE CN VS Gogo Ea Ta ee Core Sh at pea eg Se ge ee ee ee Pg gS oe 4q 
| { {40 { PO | 
{| Name } Type |!Diagram | Name 
Lee Ss re i a ee er ee ee ee ae ere a ee eS ee | 
| InitializaticnyTermination Routines { 
[ee ea a ee ee ee ee ee eae eee ee { 
{ IGccQoic { Load | None | None | 
| IKTAYS | Assembly {| None {| IKTAY8 | 
| IKTAY81 | Object } 1.6 | IKTAY8 | 
/ IKTAY82 { Entry { 1.7 {| IKTAY8 { 
| IKTAY83 | Entry { 1.8 {| IKTAYS8 i 
| IKJEFLE J Load | None | None | 
{ IKTXLOG | Object, Asseakly [ Vez j} IKTXLOG | 
i IKTLOGR {| Object, Assenaktly } 1.3 ij IKTLOGR | 
{ IKJEFLA | Load j} None { None | 
| IKIXINIT { Object, Assembly | 1.1 {| IKTXINIT { 
| IKTIION | Object, Asseskly { 1.1.1 } IKTIIOS | 
i IKTRPLXT {| Object, Assently { 1.1.2 | IKTRPELXT | 
| IKTLOGFF | Object, Assently { 1. | IKTLOGFF | 
| IKTINX2 {| Object (user-written) | 1.1 {| IKTINX2 i 
| IKTLTERS {| Load, Object, Assembly| 1.5 |} IKTLTERS | 
ee ee ee ee ae ae es ae ee a ee a ea ee a a ewe ee ewe noe J 
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me eo ce oe we ee ee a ee a ei ie ee ee ee eee ee eee ae eee ee ee eee ee eee ee ae i ee eee ee ee 


1 MO | PO 


| Name i Type {Ciagram | Name 

| ee ceo wm ee eee rm ee re ee nee ee wee we we re me we ne ne we oe we ee ee oe a ee ae ae ae ae ae ie i ee we ae a 
| TGET/TEUT Routines 

| Ne ee ee ee ee 
} IGcd0d09C } Load { None { None 

| IKTVTGET {| Object, Assenakbly { 2.1 | IKTVTIGET 

| IKTVTPUT | Object, Asseatly | 2.2 | IKTVTPUT 

{ IKTASTPT { Object, Assembly {| 2.3 | IKTASTPT 

| IKTXMTPT }] Object, Assenkly | 2.3.1 |} IKTXMTPT 

[ IKTXMFRR | Entry Ll 2eted | IKTXMTPT 

| IKT93EST | Object, Asseutly { 2.4 j IKT93EST 

{ IKIGETXT { Object (user-written) | 2.1 | IKTGETXT 

| IKTIDSX4Y { Object (uSer-written) | 2.1 | IKTIDSXK4 

| IKTRTX4& | Object (user-written) | 2.1 | IKTRTX4 

| a a em ee mem ee me ee ee ee nee eee re ee me we ee ee me ee ee ee em we ee ee ae ee we we ee ee a ee ee 
| Terminal I/C Managers 

{ em ee ee ee we ee ee we ee ee wee ee ee ee ee ee ee ee wee ee we we ee we ae we eee we we ee es eee we 
} IKTIOMOO | Load | None { None 

| IKTEXIT | Object, Asseotly | 3.7 { IKTEXIT 

| IKIISTOO | Object, Asseorly j 3.12 { IKTISTOO 

| IKTIOFRR | Object, Assenkly } 3.11 | IKTIOFRR 

| IKTICMNO1 | Load } None | None 

| IKTTIMRT { Object, Asseably { 3.3 { IKTTIMRT 

{ IKTIMFRR | Entry {| 3.3 | IKTTIAMRT 

{ IKTTOMRT | Object, Assearly | 3.4 | IKTTOMRT 

{ IKTOMFRR [{ Entry {| 3.4 {| IKTTOMRT 

| IKTRIX1 | Object (user-written) | 3.4 { IKTRTX1 

{ IKTRTX2 {| Object (user-written) | 3.3 { IKTRTX2 

| IKTRTX3 { Object (uSer-written) | 3.3 {| IKTRTX3 

}] IKTIOMO2 { Load { None | None 

| IKTIMILCS | Object, Assembly j 3.1 | IKTIMIDS 

| IKTOMIDS { Object, Assenotly {32 | IKTOMIDS 

| IKTIDS&X1 {| Object (user-written) | 3.10 | IKTIDSX1 

| IKTIDSX2 | Object (user-written) { 3.9 {| IKTIDSX2 

{ IKTIDSX3 {| Object (user-written) | 3.1 {| IKTIDSX3 

| IKTATTIN | Object, Assembly { 3.93 | IKTATTN 

| IKT3270I1 | Object, Assemkly { 3.9 {| IKT32701 

| IKT32700 | Object, Assemktly | 3.10 | IKT32700 

| IKTICMO3 { Load | None { None 

| IKTIDSX5 {| Object (user-written) | 3.5 | IKTIMLU2 

| IKTIMLU2 | Object, Assenrly eee tee | IKTIMLU2 

| IKTOMLU2 |} Object, Assenmtly | 3.6 {| IKTOMLU2 

| IKTASCII | Load, Okject, Assembly! 3.1,3.2,] IKTASCII 

| | 1 3.3,3.4 | 

{ IKTTOMJR | Load, Orject, Assembly| 3.2.1 } IKTTOMJR 

H ee ee ee ee a ee ee ee ee ee oe ee ee ee a ee a ae i ew ee ee ow ew we ee 
| Cueue Manager 

| ee ae eee ae ee ee ee ee we ee we ee ee ee ee ee a a i i a ae ae a a a a a a a ee oe 
| IKTGMNGR | Assemkly | None | None 

| IKTQMIN | Load, Ckrject } 4.1 | IKTQMBNGR 

| IKTQMOUT {| Entry f 4.2 {| IKTCMNGR 

| IKTQMFR1 | Entry { 4.1,4.2 | IKTOMNGR 

| IKTOMFR2 | Entry 1 4.1,4.2 | IKTQMNGR 

| IKTOQMEV | Entry { 4.1,4.2 {| IKTCMNGR 
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ee ow ee oe we ee ee oe ee ee ee a oe a ee os i ws i ss ee eo ee ee ee 


i {uO 1 PO 


Nage | Tyre {Diagram | Nase 
Terminal Control Macro Routines 
(=> ne ee eee eee ee ee eee es 
{ IGCOQ0OO9D | Load { None | None 
| IKTQOO9D | Object, Asseatly {| 5.1 } IKTOOOID 
1 IKTO94G01 } Object, Asseskbly 1 5.2 { IKTO9401 
| IKTOIGOY | Object, Asseatly 5.3 {| IKTO94O4 
| IKTO94O5 {| Object, Assenkly 1 5.4 | IKTO9405 
| IKTO94GO9 | Object, Asseatly { 5.5 | IKTO9409 
| IKTO9GOA {| Object, Asseusbly {| 5.6 | IKTO94OA 
| IKTOIGOC { Object, Asseakly | 5.7 ) IKTO94OC 
] IKTO94OD | Object, Asseakly {| 5.8 | IKTO94OD 
{ IKTOQUOE | Object, Asseably | 5.9 {| IKTOSGOE 
[ IKTOS4OF { Object, Asseatly [ 5.10 | IKTOS4OF 
| IKIT09412 {| Object, Asseakly } 5.11 {| IKTO9412 
| IKT094 13 } Object, Asseatly | 5.12 { IKT09413 
{ IKT094 14 | Object, Asseakly } 5.13 } IKTO9414 
pes HS S335 F SSS 5s Se ee Sree ee SSeS Se ee eee = 
{ IKTMSGS | Load, Okject, Assembly{ None } IKTMSGS 


VTIOC Directory 


e2wwe wwe =] @ we we wwe ewe ee we! Sw eS @ Owes wm |] wes Sew eee SBeOlOwWeses = ws Owes OWe 2 Owe wes ww w= 
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This section provides information about VTIOC data areas. It contains: 
e A VTIOC control block overview (Figure 10) 


e Lescriptions of several key internal data areas used by VTIOC 
routines 


A cress-reference between data area names and VTIOC object modules that 
use them is contained in the system data area usage table microfiche, 
CS/VS2 Data Area Usage Table, SYB8-0742. A list giving the names cf 
data area fields and the VTIOC object modules that update them is 
ccntained in the system sysbol usage table microfiche, OS/V¥S2 Symbol 
Usage Table, SYB8-O744. 
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CVT 


1012 TCAST 
(3F4) CVTTCASP 
68 | TCASTSB 


TSB Chain 


aE Ss ea 
TSB) 


 TVWA 

8 TVWATIMW 
(B) 

i TVWATOMW 
(C} 

32 
ee TVWABIO 
44 


(2C) TVWABOQ 


64 
(40) TVWATCB 


88 

(58) TVWAACB 
92 

(5C) TVWANIB 
96 

(60) TVWARPL 
100 

(64) TVWAEXL 

176 

. (BO) TVWAQMLB 


TIMWA 


Input queue 


TSB XBCK 
(A previous TSB) 


TSBXTVWA 
TSBXCSAP 


TSBXLBUF 


Output queue Logon buffer 


Queue manager 
look-aside buffer 


Figure 10. VTIOC Control Block Overview 
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The input queue manager farameter list is used by VTIOC routines that 
reguest input queue ganager services. It is used to pass parameters 
to the input gueue manager and to receive parageters from the input 
gueve manager. Macro IKTIPARM (acronym IPARMS) maps the parameter 


cff- 

set Length Name Description 

0 (0) 4 IPBUFADR Address of queue element's message area 
4 (4) 1 IPREQ Reguest code: 

1 = Add element to queue 

2 = Obtain message from next element 

3 = Remove element from gueue 

4 = Update an element 

5 = Remove all elements 

6 = Remove unavailable elements 

7 = Mark elements available 

5 (5) 1 IPRC Return code: - 

1 = Successful (request code 1 or 4) 
or successful and there are more 
elements on the queue (request 
code 2 or 3) 

2 = Unsuccessful (reguest code 1 or 4) 
or successful and this is last 
element on queue (request code 2) 
or successful and queue is empty 
(request code 3) 

3 = Unsuccessful (request code 3) 

€é (6) 2 IPBFSZ SNessage length 
& (8) 2 IPFLAGS Flags: 
IPALLOC Meche: (Weave Element allocation method: 
0 = GETCELL 
1 = GETMAIN 
oXXX XXXX Reserved 
IPAVBL lower dates This message is available 
IPPRMPT palgie “odes This message is prompted for 
IPPRTL wil ae - aca This is a partial message 
oe eX XXXX Reserved 
1C (A) 1 IPccc Control character count 
11(B) 1 IPTRMTYP Terpinal type 
12(C) 2 * Reserved 
1H (E) 2 IENXBFSZ Size of next message 
16(10) 2 IPNXFLGS Flags of next message: 
IPNXALC Lene ees Element allocation method: 
0 = GETCELL 
1 = GETMAIN 
XXX XXXX Reserved 
IPNXAVBL Vietere. sarees The following message is 
available 
IPNXPHT elle ace els The following message is 


prompted for 
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Cff- 
set Length Name Description 
IPNXPRTL ool. ween The following message is 
a partial message 
o2eX XXXX Reserved 
16(12) 1 IPNXCCC Control character count of next message 
19(13) 1 IPNXYTAMTP Terminal type associated with next 


message 


ae oe a Pee oe —_ — —— a 


The cutput queue manager parameter list is used by VTIOC routines that 
Leguest output gueve ganager services. It is used to pass parameters 
to the output gueuve manager and to receive parameters from the output 
gueve wanager. Macro IKICPARM (acronym OPARMS) maps the parameter 


Cff- 

set Length Name Description 

0 (0) 4 OPBUFADR Address of queue element's message 
area 

4 (4) 1 OPREQ Reguest code: 

1 = Add element to bLottom of queue 

2 = Obtain messeage from next 
element 

3 = Remove element from queue 

4 = Update an element 

5 = Remove all elements 

6 = Reset next-element pointer to 
point to top of queue and oktain 
message from next element 

7 = Reset next-element fointer to 
point to top of queue 

8 = Add element to top of queue 

§ (5) 1 OPRC Return code: 

1 = Successful (request code 1, 4, 
or 8) or successful and there 
are more elements on the gueue 
(request code 2 or 6) 

2 = Unsuccessful (request code 1, 
4, or 8) or successful and this 
is last element on gueue 
(request code 2 or 6) 

3 = Unsuccessful (request code 2 
or 6) 

. € (6) 2 OPBFSZ Message length 
8 (8) 1 OPFLAGS Flags: 
OPALLCC Ria ees Element allocation 
method: 
0 = GETCELL 
1 = GETMAIN 
OPADTOP -1... .... This element added to 
top of queue 
~--XX XXXX Reserved 
9 (9) 1 CPOFTNS Options: 


OPHOLD , ae a ae 0 TPUT NOHOLD, 


TPUT HOLD 
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10(A) 4 
14(E) 2 


16(10) 1 


17(11) 1 


18(12) 2 


Nase 
OPERK 


OPECIT 


OPASID 


* 


OFNXBFSZ 


OPNXFLGS 
OPNXALC 


OPNXADTP 


OPNXHOLD 
CPNXBRK 


OPNXELCIT 


OPNXASILC 


Description 
shes #4 ox O = TPUT NOBREAK, 
1 = TPUT BREAK 
0oeXX ..-- OO = TPUT EDIT, 
01 = TPUT ASIS, 
10 = TPUT CONTROL, 
1171 = TPUT FULLSCR 
Cera eae TPUT ASID 
re eae © © | Reserved 
Reserved 


Size of next sessage 


Flags of next message: 
Element allocation method: 
0 = GETCELL 
1 = GETMAIN 
This element added to top 
of queue 
Reserved 


» rae @ee#es 


oe ene e@es 


ooXX XXXX 


Options of next message: 
> a ae ee 0 TPUT NOHOLD, 


1 = TPOT HOLD 
okies te o% O = TPUT NOBREAK, 
1 = TPUT BREAK 
a? @ aera 0Q = TPUT EDIT, 
01 = TPUT ASIS, 
10 = TPUT CONTROL, 
11 = TPUT FULLSCR 
See Cer TPUT ASID 
ere © © 4 Reserved 
Reserved 
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Ingut Cueve Element 


a —_— =e ew oe ane 


Input gueue elements make up the input gueve. They are used Ly the 


queve manager to handle input data. 


Size of this element 


Oftset to start of message 


Offset to current first byte of message 


Size of message 


4 next element (0 if only or fast element on queue) 


4 previous eiement (0 if only or first elernent on queue) 


16 (10) P71) 18 (12) 
Flags: Flags: 


19 (13) 


X Element allocation Message avaiable for Control chai acter count Terminal type 


method: obtain 
QO = GETCELL Message was prompted 
1= GETMAIN for 
Partial message 


Reserved Reserved 


x x KX MK RK 


20 (14) 
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Cutfut Queve Element 


Cutput gueue elements make up the output queue. They are used by t 
gueve manager to handle cutput data. 


Size of this element 


Offset to current first byte of message 


6 (6) 
Offset to start of message Size of message 


4 next element (0 if only or last element on queue) 


4 previous element (0 if only or first element on queue) 


16 (10) 17 (11) 19 (13) 
Flags: Flags: 
X Element allocation QO = TPUT NOHOLD 
method: 1 = TPUT HOLD 
0= GETCELL O = TPUT NOBREAK 
1= GETMAIN t = TPUT BREAKIN 
1 00 = TPUT EDIT 
x 01 = TPUT ASIS 
x 10 = TPUT CONTROL 
x 11 = TPUT FULLSCR 
x 
x 
x 


Terminal type 


Add to top of queue 


TPUT ASID 


Reserved 


20 (14) 


Message 
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This secticn contains information that can be used to diagnose VTIOC 
problems. It contains: 


e Message lists containing the names of object modules that detect 
the conditions requiring sessages, issue the pessages, and contain 
the message text 


e An ABEND codes list ccntaining the names of object sodules that 
detect the conditions requiring ABEND codes and issue the codes 
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The following messages are issued by VTIOC object modules. For 
explanations of the system messages see OS/VS Message Library: VS2 
System Messages, GC38-1002. For explanations of the terminal messages 


see OS/VS2 TSO Terminal Bessages Directory, SY¥28-0654. 


Message Module Module Module 
5G as Detecting Issuing Containing 
IKT1001 IKTLTERM IKTLTERM IKTMSGS 
IK11011 IKTLTERM IKTLTERS IKTMSGS 
IK1102I IKTLIERM IKILTERS IKTMSGS 
IKT1031 IKTLTERM IKTLTERM IKTMSGS 
IKT 1041 IKTXINIT IKTXINIT IKTMSGS 
IK1I1051 IKTXINIT IKTXINIT IKTMSGS 
IKT1061 IKTXINIT IKTXINIT IKTMSGS 
IK11071 IKTLTERM IKTLTERB IKTMSGS 
Terminal Messages 
Message Module Module Module 
It Detecting Issuing Containing 
IKTCO3IOOL IKTLTERM IKTLTERM IKTMSGS 
IK1CO301I IKTLOGR IKTLOGR IKTMSGS 
IKTCOMOOL IKTIMIDS IKTOMIDS LKTMSGS 

IKTTIMRT IKITOMRT 

IKTQMIN IKTOMIN 

IKTIMLU2 IKTCMLU2 

IKT32701 
IKTCO4O1L IKTQMIN IKTOQMIN IKTMSGS 
IKTOOUO2I IKTTIMRT IKTTOMRT IKTMSGS 
IKTCO4UO3I ‘IKTTCMRT IKTITOMRT IKTMSGS 
-IKTOO4OSI IKTOMIDS IKTOMICSE IKTMSGS 

IKTIMLU2 IKTCMLU2 

IKTOMLU2 


Arend Codes 


‘Ihe following akend codes are issued by VTIOC object aodules. 


explanations of the codes see OS/VS Message Library: 


GC 38-1008. 


Code 


OAB 


OAD 


Module 


IKTIMIDS 
IKTIMLU2 
IKTLOGFF 
IKTLTERS 
IKTOMIDS 
IKTOMLU2 
IKTTIMRT 
IKTTOMRT 
IKTXINIT 


IKTQMIN 


Mcdule 


IKTIMNICS 
IKTIMLU2 
IKTLOGFF 
IKTLTERS# 
IKTOMIDS 
IKTOMLU2 
IKTTIMKT 
IKTTOMRT 
IKTXINIT 


IKTQMIN 


Ws2 Sys 
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t 


F 
£s 


133 


TCAS INTRODUCTION 


The terminal control address sface (TCAS) accepts logon reguests fron 
TSO/VTAM users and creates an address space for each user (see Figure 
1). When the system operator issues a START command to start TSO/VTAM 
time sharing, an address space is created for TCAS as a VTAM application 
Erogram. Then, when a user attempts to log on to TSO/VTAM time sharing, 
TCAS accepts the logon request, creates an address space having a unique 
VIAM application ID for the user, and transfers control of the terainal 
to the newly created address space. From this foint on communication 
gces from the terminal through VTAM to the user's address space (that 
is, to TSO via the VTAM terminal I[/0 coordinator (VTIOC)). 


TCAS has four functional components: 


e ICAS pain task. The main task processes the START command, handles 
TCAS initialization and termination, creates the TCAS table (TCAST), 
Frocesses START and MODIFY command parameters, and attaches the 
three TCAS subtasks. 


e VTAM interface subtask. This subtask opens and closes ACEs, accepts 
and guiesces logons, transfers and releases terminal control, and 
provides VTAM exit routines (logon, TPEND, CLSDST, and Bind). 


e User interface subtask. This subtask creates and terminates user 
address spaces, and adds TSEs to the TSO/VTAM TSB chain. 


e Console communication subtask. This subtask processes the MODIFY 
and STOP commands. 


ICAS carries out its functions by performing units of work that are 
represented by work elements (see "TCAS Data Areas" for a description 
cf a work element). The work elements are queued and thus represent 

a series of work to be dcne by a task. (The one exception is VTAM exit 
routines, which are not gueued as work elements but are scheduled by 
VTAB.) There are two types of queues: synchronous and asynchronous. 
There is one synchronous gueuve for all the TCAS tasks. There are cne 
or more asynchronous queues for each TCAS task. 


Fach TCAS task, when its ECB is posted, looks for work on the 
Synchronous queue. If the synchronous queue is empty, it looks for 
work on one of the asynchronous queues. When each task finishes its 
work it enters a wait state, cr posts another task if any work was 
created for one. 


Ihe synchrcnous queue ccntains work elements to handle work requiring 
synchronization of all the TCAS tasks. Elements on the synchronous 
gueuve are created to process the START command, the MODIFY command, 

the STOP command, and error recovery. The asynchronous queues consist 
cf the ACB control queue, the global terminal handling queue, the local 
terminal handling queue, the TPEND queue, the address space creation 
gueue, the STOP command queue, and the MODIFY command queue. 


When the work represented by the first vork eleswent on the synchronous 
gueuve is finished, the task that executed the first work element 
examines the second work element to determine which task should receive 
ccntrol next. The first work element is dequeued and the task of the 
second work element is posted. This processing is fropagated until 

all the work on the synchronous queve is finished. 
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Rhen the work represented by the first work element on an asynchronous 
queue is finished, the task that executed the first work elenent 
degueues it and executes the next element. This processing is 
Fropagated until all the work cn an asynchronous queue is finished. 
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This section uses the HIPO (hierarchy plus input-process-output) 
technigue to graphically describe the functions performed by TCAS. It 
ccntains a visual table cf contents and diagrams. 


The visual table of contents (Figure 11) contains the names and 
identification numbers of all the diagraas. There is a diagram for 
each pajor TCAS function. The diagrams show functions performed and 
Significant inputs and outputs; they do not show organization of a 
routine or processing flcw within a routine. 


Cenventions Used in HIFO Diagrams 


At the top of each diagram is a diagram ID consisting of an 
identification number (MO number) and a description of the routine. 

The identification number provides a way of locating a diagrap through 
the visual table of contents or the directory ("TCAS Directory"). Below 
the diagram ID are input-frocess-output blocks and extended description 
Elocks. 


The input block shows data that serves as input to the processing steps 
in the processing block; the cutput block shows data that is output 

from the processing steps. The symbols used in and between these blocks 
are explained in the legend (Figure 2). Each processing ster is 
numbered; the number corresponds to a note in the extended description 
kicck. The notes provide additional information for the processing 
steps. The routine name and labels identify the code that performs 

the function of each ster. 


TCAS Main Task 
Routine 


TCAS VTAM 
Interface Routines 


TCAS User 
Interface Routines 


TCAS Console 
Communication 
Routines 


6.1 6.2 6.3 


Figure 11. TCAS Visual Table of Contents 
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MO 6.0 (Part 1 of 2) TCAS Main Task 


Input From Started Processiny Out put 
Task Control 

(STC) after 

START 

command 


Call the TCAS initializa- telah 


tion routine to initialize Main Task 
the TCAS work area (TWAR). Seqment 


not exist. TSO information 


TCAS status 
TCAS ASCH IN 
fee ee 


'TCAST, tCSCB 
ee 


(4] Check the parameters Register 15 


VIAM Interface 
Seqrment 
’ User Interface 
Se t 
(2] Establish the FSTAE exit Same) 
routine. “ 
Console Communica- 
tion Segment 
Addressability 
“Yain task flag byte for [KTCASS3- 
IKTCAS5S6 
“LNLOTBA i =, =e ea [3] Cal] the TCAS table 
(no TCAST) Creation routine if the 
TCAS table (TCAST) docs 
a ae EA 


ee ee passed in the START 04" 
command by calling the Ke 04 Unsuccessful 
TCAS parameter processing X'00' Parameters ok 
scanner, 


TCAST 


The TCAS main task processes the 
START command and coordinates the 
TCAS subtasks. 


The initialization 


routine allocates storage for 
the TWAR, initializes it, and 
establishes addressability for 
other TCAS routines by storing 
their addresses in the 

TWAR. 


[4] The parameter processing 
6canner routine scans 
the parameters passed from the 
START command, reads the param- 
eter member from parmlib, 
uodsates the TCAST with the 
parmlib parameters, and writes 
the parameters used to SYSONT. 


(2] The ESTAE exit routine IKTCASS5 
receives control from R/TM. 
It performs the following 
functions: 


@ Passes control back to R/TM 
for cleanup 


Passes control back to R/TM 
to retry the failing task 


Creates a work element to 
reattach the failing task if 
the task has not previously 
abended 


Creates work elements to 
terminate TCAS if the main 
task or a previously abended 
subtask is failing. 


[a] The TCAS table creation IKTCASS 3 
routine allocates storage for 
the TCAST and initializes it. 
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MO 6.0 (Part 2 of 2) TCAS Main Task 


Inpat Processing Vutpue 


(s} Create work elemente and 
queue them on the 
synchronous queue. 


Branch 
Register 16 Entries 


Find the work element on 
the top of the synchro- 


wi nous gueue and pase 
control to the routine it 

eee represents (ATTACH with 
ESTAI). 

aR, 


(MO 6.3) 


Determine whether all WE : 
represented functions are STOP Command 
complete. If not complete, entered 
return to step 6. If com- Invalid START 
plete, enter a wait state Command 
or call the termination VTAM interface 
routine to finish ABEND 
processing. User interface 
ABEND 
Console Communica- 
tion ABEND 


Return To STC 


8 


{s] The sequence of work elements IXTCASOO 
is as follows: 
A, Attach user interface driver. 
A. Terminate the address space 
(if any TSO users are active 
and the operator wishes to 
terminate them). 
Attach VTAM interface driver. 
Attach console communication 
driver. 
» Start logon. 
» Return, 
The subroutine that selects IKTCASOO 
work eclenents from the top of 
the synchronous queue posts 
each work element in order. 
After the routine represented 
by the work element finishes 
its work, it returns to MLSLT 
in the main task. 


[7] If the system operator has 
entered STOP TSO, the termina- 
tion service routine is called 
to perform final processing. It 
issues the SDUMP macro to pro- 
vide a virtual storage dump if 
the system operator replies 
DUMP to termination message 
IXTO12D. It then detaches the 
VTAM interface, user interface, 
and console communication sub- 
tasks, and frees cross~memory 
requests on the work element 
queue by posting the ECBs 
specified in the work elements 
and by freeing work element 
storage. 
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MO 6.1 (Part 1 of 2) TCAS VTAM Interface 


Posted by TCAS 
Input Main Task (MO Frocessing Output 
6.0), TCAS 
User Interface 
(MO 6.2) , OF 
TCAS Console 
Communication 
(MO 6.3) 


Inspect the synchronous 
gueuc. Tf a work element 
is found for the VTAM 
interface subtask, do one 
of the following: 


Open the ACB 


Tssue SETLOGON to accept 
Or quieace logons 


Close the ACB 
End the task 
If a work element is found 


for another task, post one 
of the following, then 


wait: TCAS Main 
T 
@ ‘ain Task ae e 0) 
TCAS User 
TWAVTEQH 
e User Interface am Interface 
(MO 6.2) 
@ Console Communication TCAS 
Console 
Communicatio 
Process the asynchronous {MO 6.3) 
queue work elencnt, if 
Present, to terminate 
TCAS. 
TWAVTIIOH 
at ey 
Process the asynchronous 
TCAST queue work element, if 
present, to transfer or 
TCASTTQH release the terminal. 
(ee 
Wait 


Q) The TCAS VTAM interface subtask |IKTCAS20 
inspects the TCAS queues in this 


order:: 


(1) Synchronous queve 
(2) TPEND queue 


(3) Terminal handling queue. 


It gives control to a routine 
represented by a work element 
en one of the above queues. 


If the request cannot be 
processed by IKTCAS21, the 
function code is changed to the 
criginator's function code to 
give control back to the 
originator. 


If IKTCAS21 processes the 
request successfully, it sends 
back an end of task work clement 
which IKTCAS20 dequeues. 
IKTCAS20 then posts the user 
interface and console communica- 
tion routines to see if they 
have any werk. 


IKTCAS20 


A TPEND work element is added 
to the asynchronous TPENP queue 
if the synchronous queue 1s not 
empty. 


TKTCAS24 


IKTCAS20 calls IKTCAS22 to 
process work elements on the 
global and local terminal 

handling queues. 


IKTCAS 22 


Based on the work element func- 
tion code, IKTCAS22 calls 
IKTCASCX (Release/Pass TKTCASCX 
Asynchronous Exit), which 
{1) Verifies the completion 
session with a terminal 
or 
(2) Verifies the comoletion 
request to pass control 
the terminal to another 
application program. 
If either operation is not com- 
plete, IKTCASCX can initiate a 
retry. 
If control of a terminal was 
passed, IKTCASCX frees the con- 
trol blocks allocated in step ¢. 
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MO 6.1 (Part 2 of 2) TCAS VTAM Interface 
Input From VTAM (Logon) processing 


Register 1 


(4) Provide workspace and con- 
, Parameter nen trol blocks necessary for 
List logon. 


[s} Yf there is not enough 
storage, reject with 
CLSDST. Check terminal 


1 Address of ACB 


2 Symbolic terminal ID eherectertectcs: 
¥ Reserved hy VIAM ig Fncode the characteristics 
$ Length of loqon rag in & work element. 

7] Pass control to a user 


exit routine if one exists. 


Establish connection 
between TCAS and the 


terminal. 


From VIAN 
(TPEND) 


Create work elements to 
close the ACB and termin- 


ate TCAS. 


j rots rmutine | ater | nee 


IKTCAS23/RPLENTRY 


Get storage for and begin to 
initialize the WE, LB, RPL, and 
NIB. 


TXTCAS23 checks device character- 
istics by issuing an INQUIRE 
macro to obtain session param- 
eters and by comparing these 
parameters to the terminal char- 
acteristics, If tha request is in 
error, @ CLSDST RELEASE macro is 
issued to tell VTAM to disconnect 
the terminal. When the request is 
honored, IKTCASCX receives con- 
trol to free the control blocks 
allocated in step 4. 


TKTCAS23)|DEVERIFY 


The user exit routine, 
IKTINX], can halt logon process- 
ing if it Finds an invalid 

device. 


Connection between TCAS and the 
terminal is established by issu- 
ing .n OFNDST macro. Control 
returns from VTAM (after OPNDST) 
to IKTCASOX, which constructs 
another work element to create 
the user address space. This 
work element is queued to the 
user interface routine. 


IKTCAS23 | RPLINTO 


IKTCAS20 dequeves the last work 
element on the asynchronous 
queue and calls IKTCAS24, the 
TCAS VTAM TPEND exit routine. 
If the synchronous queue is 
empty, work elements are put on 
the synchronous queue to close 
the ACB and terminate TCAS. If 


TKTCAS20 


To 
Caller 


acces routine | tates | nat 


the synchronous queve is not 
empty, the TPEND exit routine 
creates a TPEND work element 
and queues it on the TPEND 
asynchronous queue. 
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MO 6.2 (Part 1 of 2) TCAS User Interface 


Input Posted by TCAS Processing Output 
Main Task (MO 

6.0), TCAS 
TWAR VTAM Interface 


(MO 6. 1) ,» or 
Jrwasyncn | TCAS Console 
ee Communication 
(MO 6.3) 


Inspect the synchronous 
queue. If a work element 
is found for the user 

interface subtask, dc one 
of the following: 


ca) 


@ Cancel the TSO user 
normally (system- 
initrated cancel) 


List of ASCR 
addresses ta 
cancel 


@ Force immediate cancel- 
lation of the TSO user 
(CALLRTM TYPE 2 MEMTERM 


Initialization 


@ End the task 


If a work element is found 
for another task, post one 
of the following, then 

wait: 


@ Yain Task 


(MO 6.1) 


TCAS 
User 


Interface(MO 6.2) 


® User Interface 


@ Console Communication 


Console 
Communication 
(MO 6.3) 


Process the asynchronous 
queue work element to 

create an addresa space 
for a new terminal. 


TWAUACOI 


(a) If the maximum user 
count is exceeded, 

issue a Message to 

the user. 


Logon Buffer 


If storage cannot be 
obtained for the TSB 
or logon buffer, issue 
a message to the user. 


. (1 ] The TCAS user interface subtask /TKTCAS30 [2] TKTCAS30 dequeuves the work TKTCAS 31 
inspects the TCAS queues in element and then calls IKTCAS31, 
this order: the address space creation 

‘ routine, which 

(1) Synchronous queue. 

(a) Check maximum user count. 

(2) Address space creation 

queue (address space for 


(b) Gets an address space by 
use by a terminal). 


issuing SVC 34. 


IKTCASIO gives control to a 
routine represented by a work 
element on one of the above 
queues. 


{c) Initializes an ASCB, a TSB, 
a TSBX, and a logon buffer. 


(d) Calls IEDAY3 to synchronize 
oa the new address space 

To free user address spaces, : initialization. 
IKTCAS30 calls IKTCAS32, the LKTCAS 32 

address space termination 
routine, which gets temporary 
storage to list the address of 
each ASCB, 


(e) Calls IKTCAS33, the TSB 
manipulation routine, to 
queue a TSB. 


IKTCAS32 calls IKTCAS33, the IKTCAS 33 
TSB manipulation routine, which 
lists tha ASCB addresses in the 
temporary storage. IKTCAS32 
then issues the CALLRTM macro 
instruction to termirate the 
users' address spaces. 


If the request 1s to issue a 

system cancel, IKTCAS39 louds 

each ASCB address and calls STC 
‘ to cancel each user. 
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MO 6.2 (Part 2 of 2) TCAS User Interface 


Input Processing Output 
4 If a failure occurs during kf 

address space creation, TWAR 
release the terminal by 
creating a work element [rWavTHON 
for the VTAM Interface, ae 
which releases the 
terminal. 
If address space creation 
fails, issue a message } we | 
to the user. ; 


Wait 


[4] After IKTCAS31 returns to IKTCAS31 
IKTCAS30, if address space crea- 
tion failed, IKTCAS30 posts the 
VTAM interface. 
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MO 6.3 TCAS Console Communication 


Processing Output 


Input 


Posted by TCAS 
Main Task (MO 
6.0), TCAS 

VTAM Interface 
(MO 6.1), TCAS 
User Interface 


(MO 6.2) or 
the Command 
Processor 
TWAR 
Check for operator STC} 
and MODIFY commands, fuild Pe se 
work clements and queue 
each one on an asynchronous TWACHODO 
queue. 
ETE | Process the synchronous 
ee queue. 


Process the stop qucue 
(last. work element 
proenssed first). 


Process the modity queue 
(last work element 
processed first). 


rowtine | tater | ne | joer | tutine | aber | nee 


elements are built to cause an 
orderly shutdown of TCAS: 


The console communication subtask 
handles the STOP and MODIFY 

operator commands. Other TCAS func- 
tions can use this routine by placing 
a work element on eather the STOP 
queue or the MODIFY queue. 


@ A WE for the VTAM interface to 
Close the ACB. 


@ A WE for the user interface to 
CHKECBS terminate the address space, 
BLOSTPWE 


BLOMODWE 


[.] After using a CIB (command input 
buffer) to build a work element, 
IKTCAS40) uses the QEDTT macro to 
free the CIB. 


@ A WE to tell about the 
termination request. 
TKTCAS42| PRCSMODE 


[2]: rs the synchronous queve is CHKSYNCQ [4] IKTCAS4O calls IKTCAS42 to 
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empty, continue processing with 
step 3, ~". 


If the first work element 1s not 
for console communication, post 
the owner and wait. 


If the first work element is for 
console communication, process 
work elements for normal return, 
end of-task, and abnormal end. 


If the queve is empty now, post 
the other TCAS tasks and exit. 


Repeat processing if the new 
first work element is for console 
communication. 


IKTCASIJO calls IKTCAS41 to 
handle work elements on the 
STOP queue by building work 
elements on the synchronous 
queue; the following work 


PRCSSYNE 


handle work elements on the 
modify queue by building a set of 
work elements for the synchronous 
queue that cause the modification 
to be made. Parameters in the 
work element extension show what 
type of work elements should be 
built. When finished building 
work elements, IKTCAS42 posts the 
task indicated by the top work 
element on the synchronous queue. 


ICAS FROGRAS ORGANIZATICH 


This section describes TCAS modules and shows control flow among then. 
There are two parts: 


e A figure (Figure 12) showing control flow among the TCAS sodules 
e A description of each ITCAS sodule giving: 
Names 
MO Diagram - in which the aodule is descrikted 
Function 
Entry fros 
Registers at Entry - contents of relevant registers 
Exit to 
Registers at Exit - contents of relevant registers 
External References 
Control Blocks Used 
Mapping Macros Used 
Executable Macros Used 
Module Attributes 
Lock Dependency - requirements at module entry 
Messages - detected by and issued from each module 
Abend Codes 
Data Sets 


The module descripticns are arranged alphamerically by module name. 
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Cae 


TCAS Main Task Driver 1K TCASS1 


CALL 
e Ininaize TWAR LInitiahzation 


IK TCAS53 
CALL ; 
e@ initialize TCAST TCAST Creation 
1K TCAS54 
CALL 
@ Process START and . Parameter Processing 
MODIFY commands Scanner 


PiKTcas20 
ATTACH [KTCAS20 


TCAS VTAM Interface 
Driver 


@ Provide interface to 
VTAM 


@ Open or close ACB, 
accept or quiesce 
logons 


TCAS21 
CALL IK TCAS2 
ACB Control 
CALL IK TCAS22 
Terminal Handling 


{K TCAS24 
TPEND Exit 


Transfer or release 
control of terminal 


CALL 


HALT NET 
(iK TCAS20 if 

IK TCAS 24 was un- 
able to finish process- 
ing when dispatched 
by VTAM} 


IK TCAS3O 


TCAS User Intertace 
Driver 


ATTACH 


= 


e Provide interface to 
terminal user 


CALL LIK TECASS1 CALL |] tKTCAS33 ‘ 
Address Space Creation "| TSB Manipulation 


e Add TSB and TSBX 


@ Create user address 
space, muitialize TSB 
and TS5x 


to chain 


IK TCAS32 


Address Space 
Termination 


~\TIKTCASXI 
on exe Cu Gm one Gm ee one om > ee oll 


1 Nonsupported Terminals | 


® System initiated 
cancel orCALLRT™M 


CALL 


@ Remove TSB and 
TSBX from chain 


4a 
ae 


e Provide interface to TCAS Console 
system console Communication Driver 


@ Handle STOP 
command 


CALL IK TCAS41 
STOP Queun Processor 


CALL IKTCAS42 


MODIFY Queue 
Processor 


e Handie MODIFY 
command 


CALL (K TCAS52 
e Prowde SVC dump. Termination 


detach subtasks, free 
terminal transfer 
requests 


e ABEND QAC R/TM 


STC 


Figure 12 (Part 1 of 2). TCAS Module Flow 
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ps er eae es asa 


Bind RU complete 


CLSDST RELEASE, 
CLSDST PASS 


HALT NET 


IKTCAS23 


Logon Exit 


Bind Asynchronous Exit 


IK TCASCX 


Release/Pass 
Asynchronous Exit 


R/TM 


Figure 12 (Part 2 of 2). 


IKTCAS52 


Termination 


TCAS Module Flow 


TCAS Prograp Organization 
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one a ED ES GD UG Eee Eee Ee ee ee ee oe eee —_— oe ee ee oe a es oe ere SRE Se EP ee ies i ee ee ee ee ee 


— ae ae aw 


Assembly Module: IKTCASCX 
Chject Module: IKTCASCX 
Alternate Entry Pcints: Necne 
Load Module: IKTCAS20 


MC Diagram: 6.1 


Functicn: VTAM schedules this routine upon completion of either a 
reguest to terminate a terminal session or a request to pass contrcl 

ef the terminal from the user's address space to another address space. 
IKICASCX verifies the ccmpleticn of the request and frees the space 


allocated to the terminal. 


Entry_from: VTA 


—_— = << ae a oe Oe ee ee ae ee ee ee ee ee 


Register 1: Address of RFL 
Register 14: Return address 
Register 15: Entry pcint address 


oo 


Fxit to: VTAS 


oe oe oe ee oe ee oe 


—_— 2 a ee ee ee ee ae ce ee oe —_ = 


Register 1: Address of RPL 
Register 14; Return address 
Register 15: Entry point address 


External References: IKTCAS5S6 ) 


Centrol Blccks Used: CVT, NIE, PSA, RPL, TCAST, TWAR, WESTD 


— see a cee eee oe Oe ee ee ee ee ee ee oe ee ee 


Mapping Macro CVT, IFGRPL, IFGRPLVT, IHAPSA, IKTCASWA IKTTCAST, 


IKIWESTD, IST 


zilvv 


Executable Macros Used: CHECK, CLSDST, EXECRPL, FREEMAIN, POST, WTO 


ee ee ee ee oe ee ee ee oe ee 


Atend Codes: None 


Lata Sets: None 


— a 


Assembly Module: IKTCASOX 
Orject Module: IKTCASCX 
Alternate Entry Points: Ncne 
Load Module: IKTCAS20 


EC_ Diagram: 6.1 
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Function: VTAM uses an IRE to dispatch this routine after VITAM receives 
notice of completion of an asynchronous Bind RU to a terminal attempting 
tc ley on to TSO/VTAM. if the Bind or a retry of the Bind is 
successful, IKTCASOX requests an address space for the terminal. If 


the Bind is unsuccessful, the terminal is freed. 


Entry ftom: VTAM 


Register 1: Address of RPL 
Register 14: Return address 
Register 15: Entry foint address 


Exit_to: VTAM 


Register 1: Address of REL 
Register 14: Return address 
Register 15; Entry fcint address 


External References: IKTCASCX 


Centro] Blocks Used: CVT, NIB, PSA, RPL, TCAST, TWAR, WESTD 
EEFing Macros Used: CVT, IFGRPL, IFGRPLVT, IHAPSA, IKTCASWA, IKTTCAST, 
IWESID, ISTNIB, ISTRPLFB 


Executable Macros Used: CHECK, CLSDST, EXECRPL, FREEMAIN, POST, WTO 


ae ee emp One oD em a ae oe me ee ee ke ee ee ee ee 


ee ee oe oe oe — ow ow ow a ow 


Atend Codes: None 


or a we ee ee oe ee ee ee 


Lata Sets: None 


Object Module: IKTCASX1 
Load Module: IKTCAS30 


Functicn: An installation must write this routine if it wants to send 
an error message to a terminal that is not supported by TSO/VTAM. 
IKTCAS31 calls IKTCASX1 if the maximum number of users is reached or 
if IKTCAS31 cannot obtain storage for either of the TSBs or the logon 
Fuffer. It also calls IKTCASX1 if the address space for this session 


cannct be obtained. 


Entry from: IKTCAS31 


w= «= — = ae om 


Register 1: Address of the message text, preceded by a full word 
that indicates the total length of the text in bytes. 

Reyister 0: Address of the RU buffer into which the edited message 
is put. 
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Reyister 14: Return address 
Register 15: Entry foint address 


Exits to: IKTCAS 31 


Registers _at_Exit: 
Register 0: Address of the output RU 
Register 1: Total length of the RU indicated by the EXIT routine 
Reyister 15: Return codes: 


O - IBM routine shculd perform editing. 
Nonzero - Exit routine performed all editing. 


Assembly Module: IKTCASOO 
Okject Module: IkTCASOO 
Alternate Entry Points: Ncne 
Lcoad Module: IKTCASOO 


MC Diagram: 6.0 


Function: This routine frocesses the START comaand by calling the 
initialization, TCAST creation, and parameter processing scanner 
reutines. It creates. work elements as necessary for user interface 
processing, console communication, logon processing and START command 
ccupletion. It calls the routines that these work elements represent. 
It also calls the termination routine if a termination work element is 


reached, or if there is an abncrmal termination. ) 


Entry from: Started task control (attached after START comsand) 


—— ee ee ee ee we ee ee 


Register 13: Address of register save area 
Register 14: Return address 
Register 15: Entry fcint address 


'xit_to: 


Started task control: Normal 
R/TM: ABEND OAC 


4 a ee ee ee ee ee ee ee ee oe 


Register 13: Address of Legister save area 
Register 14: Return address 
Register 15: Return code; 


00 STOP command entered 

O04 Invalid START command 

10 TCAS VTAM interface subtask not attached 

14 TCAS user interface subtask not attached 

18 TCAS console communication subtask not 
attached 

1¢ Storage for TCAST not available 

30 TCAS VTAM interface subtask abend 

34 TCAS user interface subtask abend 

38 TCAS console communication subtask abend 

3C TPEND occurred 
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Extern] References: IKTCAS5S1, IKTCAS52, IKTCASS3, IKTCASS&, IKTCASS6 


Control Blocks Used: ASCB, CIE, CSCB, CVT, PSA, TCAST, TWAR 


a ee et oe ee ee ee ee ae oe oe oe oe ge 


Napping Macros Used: CVT, IEECHAIN, IEZCIB, IHAASCB, IHAPSA, IKTCASWA, 
IYiTCAST 


Executable Macros Used: ABEND, ATTACH, ESTAE, FREEMAIN, GETMAIN, LOAD, 
MCLESET, POST, SETLOCK, WAIT, WTO, WTOR 


Scdyle Attributes: Serially reusable 


Lock Lependency: None 


Messages: IKTOO1ID, IKTOO2I, IKTOO3D, IKTOO4D, IKTOOSI, IKTOO6D 


Abtend Codes: OAC 


IKICAS20 -- TCAS VTAM Interface Driver 


ee ee ow EP are wee emer ee eee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee 


Assembly Module: IKTCAS20 
CEject Module: IKTCAS20 
Alternate Entry Points: Ncne 
Lcad Module: IKTCAS20 


MC Ciagram: 6.1 


one em ee ee oe ee — aoe 


Function: This routine Frocesses work element queues for the YTAM 
interface subtask by giving ccntrol to routines aucecare’ by work 
element function codes. 


Entry from: IKTCASOO 


—_ -~ op = ae OP ee oe 


Reyister 13: Address of register save area 
Reyister 14: Return address 
Register 15: Entry point address 


Fxit tec: IKTCASOO 


ee ee 


Register 13: Address of register save area 
Register 14; Return address 
Register 15: Entry fFeoint address 


External References: IKTICAS21, IKTCAS22, IKTCAS24 


Centrol Blocks Used: TCAST, TWAR 
Mapping Macros Used: IKICASWA, IKTTCAST 


Executable Macros Used: PpoST, WAIT 


are oe ae oP oe Sa a -— om wr a 8 ee ot oe 
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Messages: None ; 
Akend Codes: None “al 
Cata Sets: None 


— a a ee ee ee ee oe 


eo ee ee ee er ee es ie ee es ie ee a ee ey oe oe ee ee 


Assepbly Module: IKTCAS21 
Object Module: IKTCAS21 
Alternate Entry Pcints: None 
Load Module: IKTCAS20 


: This routine opens the terminal's ACB, issues the SETLOGON 
accept OF quiesce logcns, and closes the ACB. 


Entry from: IKTCAS20 


Register 13: Address of register save area 
Register 14: Return address 
Register 15: Entry point address 


Fxit to: IKTCAS20 


oe we we ae oe oe 


—_——_ a a a a a a oe ee oe ee ee oe 


Register 13: Address of register Save area 
Register 14: Return address 
Register 15: Entry fcint address 


External References: IKTCAS24, IKTCASS6 


ces ee ee ee ee ee ee ee ee ee ee ee ee 


Ccntrol Blccks Used: ACE, EXLST, RPL, TCAST, TWAR 


ee eee ee ee ee ee ee ee ee ee 


Mapping Macros Used: IFGACB, IFGEXLST, IFGRPL, IKTCASWA, IKTTCAST 


Fxecutable Macros Used: CLOSE, OPEN, SETLOGON, SHOWCB, WTO 


oe ee De ey ce ee ces ee ee A ee ce 


Module Attributes: Serially reusable 


ee ee ee ee em ee ee ee ee om ee es ow ee 


Lcck Dependency: None 


Messayes: IKTOO7I, IKTOQ8I 


Abend Codes: None 


— ae om oe oe oe ee et ee oe 


Vata Sets: None 


ee we ee we ee ee 


ee ee ce ee ee ee ee ee ee ee ee ee oe oe ee ee ee oe a — so a ee ep ee 


— ee ee oe 


Assembly Module: IKTCAS22 
Ckject Module: IKTCAS22 
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Alternate Entry Pcints: Sone 
Load Module: IKTCAS20 


BC Diagram: 6.1 


Functicn: This routine transfers terminal control from TCAS to the 


user's address space (CLSDST FASS) or releases terminal control (CLSDST 
RELEASE) .« 


Register 10: Address of work element 
Register 13: Address of register save area 
Register 14: Return address 

Register 15: Entry point address 


Frit to: IKTCAS20 


Register 10: Address of work element 
Register 13: Address of register save area 
Register 14: Return Address 

Register 15: Entry point address 


External References: IKICASCX 
Ccntrol_ Blocks Used: RPL, WESID 
Mapping Macros Used: IFGRPL, IFGRPLVT, IKTWESTD, ISTRPLFB 


Executable Macros Used: CLSDST, FREEMAIN 


Abend Codes: None 


Lata Sets: None 


a ewes a ee om ow 6 Oe ee Oe 2 ee oe oe a a SE ae a a ee ee eee ee ee a 


wp oe aw ow 


Assembly Module: IKTCAS23 
Object Module: IKTCAS23 
Alternate Entry Points: Nene 
Load Module: IKTCAS20 


NC Diagram: 6.1 


_— 2 = oP or oe = 


Function: This routine frovides the work space and control blocks 


— a a oe ow oe ow = 


necessary for processing a logen request. 


Entry from: VTAM (dispatched as a logon exit) 


—_— om a eo = an oe oe 
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ed _— oe a oe oe oe oe oe Ow or a ae 


Register 1: Address cf parameter list containing: 


Address of the terminal's ACB 
Symbolic terpinal IT 

Reserved 

Length of the logon message 


Register 14: Returia address 
Register 15: Entry point address 


Exit to: VTAM 


—_ wa a AD ane Sie Oe Ee eee es a ae eee = oe 


Register 1: Address cf parameter list containing: 


Address of the terminal's ACB 
Symbolic ter@inal IL 

Reserved 

Length of the logon sgessage 


Register 14: Return address 
Register 15: Entry point address 


External References: IKICASCX, IKTCASOX, IKTCASS6, I 


on ae ae ane et me an ee oe > ee om oe a oe 


Ccntrol Blocks Used: BIND, CVI, WIB, PSA, RPL, TCAST 


— —_— ee mae 


— om _aTest an a a am oe = oe 


apping Macros Used: CVI, IFGRPL, IFGRPLVT, IBAPSA, 
KT 


Executable Macros Used: CLSDST, EXECRPL, GETSAIN, ID 


8 ee ee aE ne oe > OD a > oe eo oe oe Fe ee oe ee 


WIC 


KTIWX1 
« IWAR, WESTD 


IKTCASWA, IKTTCAST, 


QUIRE, OPNDST, 


Module Attributes: Serially reusable, key 6, supervisor state 


= ee ow ae om om > 8 ee ee ee ee ee we oe 


Lock Dependency: None 


-_— ae op ee ee ao Fc 


Hessages IKTO191 


Aktend Codes: None 


Tata Sets: None 


> ate ee ee ee ee a ee. oe ee oe SP ee 8 ee ee ee ee ee et oe a 


~~ = ow oe oe 


Assembly Module: IKTCAS24 
Object Module: IKTCAS24 
Alternate Entry Points: None 
Load Module: IKTCAS20 


BC_Diagram: 6.1 


Functicn: This routine initiates TCAS termination. 


try from: VTAM (norgal) or IKTCAS20 (if processing 
ter normal entry) 
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was not completed 


Registers at Entry: 


Register 1: Address cf a parameter list (on entry from VTAM) 
containing: 


° ACB address of the terminating prograr 
e Reason for the termination 

Or 

Zero (on entry from IKTCAS20) 


Register 10: 


Irrelevant (on entry from VTA) 

or 

Address of TPEND werk element on asynchronous gueve (on entry 
from IKTCAS20) 


Register 11: Address of TWAR 

Register 13: Address of register save area 
Register 14: Return address 

Register 15: Entry point address 


Exit _to: Caller 


Register 1: Address of a parameter list (on entry from VTA) 
containing: 


e ACB address of the terminating progran 
° Reason for the termination 
Or 


zero (on entry from IKTCAS20) 
Register 10: 


Irrelevant (on entry froma VTAB) 

cr 

Address of TPEND work element on asynchronous queve (on entry 
from IKTCAS20) 


Register 11: Address of TWAR 

Register 13: Address of register save area 
Register 14; Return address 

Register 15: Return code: 


00 Normal return 


External References: IKTCASCX, IKTCASOX, IKTCAS56, IKTWAPTR (in 


a a ae ee es ee or a a a oe: 


IKTCAS20) 


Ce 


ntro] Blocks Used: TWAR 


a 


PEing Macros Used IKTCASWA 


Executable Macros Used: GETMAIN, WTO 


Lock Dependency: None 


Bessages: IKTOOSI 


Abend Codes: Nene 
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Lata Sets: None 


a ee ee ee ee ee ee ee a ee ee ee ee ee ee ee en ee es a 2 oo 2 2 2 aa 


Assembly Module: IKTCAS30 
Object Module: IKTCAS30 
Alternate Entry Points: None 
Load Module: IKTCAS30 


BC_Ciagram: 6.2 


Functicn: This routine processes work element gueues for the user 


interface subtask by giving ccntrol to routines’ indicated by work 
element function codes. 


Entry from: IKTCASOO 


Register 1: Address of tTWAR 

Register 13: Address of register save area 
Register 14: Return address 

Register 15: Entry point address 


Exit to: IKTCASOO 


Reyister 13: Address of register save area 
Register 14; Return address 
Register 15: Entry foint address 


Register 1: Address of ‘M1WAR 


External References: IKTCAS31, IKTCAS32 


me ame ce ee ee ee ee ee ee oe oe oe oe eee 


Ccntrol Blocks Used: ECE, TWAR 


Mapring Macros Used: IHAECB, IKTCASWA 


7 a ee ee ee ee ee ee ee ee eee 


Executable Maccos Used: POST, WAIT 


ee ee ee ee ee ee ee ee ee ee ee oe ee oe ee eee a 


Mcdule Attributes: Serially reusable 


Lock Dependency: None 


- Atend Codes: None 


— oe ee ee ee ee ee 


Tata Sets: None 


_— oe oe 


Assenbly Module: IKTCAS31 
Object Module: IKTCAS31 
Alternate: Entry Points: Ncne 
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Load Module: IKTCAS30 


Function: This routine issues SVC 34 to create a TSO user address 
space; allocates storage for and initializes the TSB, TSBX, and logon 
tuffer; and synchronizes the initialization of the new address space. 


Entry from: IKTCAS30 


: Address of register save area 
: Return address 
: Entry point address 


Reyister 1 
Register 1 
Register 1 


WW & ua 


Fxit to: IKTCAS30 


Register 13: Address of register save area 
Reyister 14; Return address 
Register 15: Entry fcint address 


External References: IKTCASX1, IKTCAS33, IKTCAS5S6 


a ee ee ee ep ee ee ee ee oe ee ee ee ee 


rol_Blocks_Used: ASCB, ASVT, BASEA, CVT, NIB, RPL, TCAST, TSB, 
, TWAR, WESTD 


Napping Macros Used: CVT, IEEPASEA, IFGRPL, IHAASCB, IHAASVT, IKJTSB, 


eo > ES ame ee eee eee ee eee ee ae 


IKICASWA, IKTICAST, IKTWESTD, ISTNIB 


Executable Macros Used: FREEMAIN, GETAMIN, MOLESET, POST, SEND 


Bessages: IKTOOQ201I, IKTOO2021I, IKTOO203I 


Atend Codes: None 


[Tata Sets: None 


me a Dee eee cee ee ee Oe Oe ew a oe ee oe eee oe ed 


~~ a —- = 


Assembly Module: IKTCAS32 
Object Module: IKTCAS32 
Alternate Entry Pcints: Ncne 
Lead Module: IKTCAS30 


BO_Liagram: 6.2 


Function: This routine calls the system-initiated cancel routine or 


issues CALLRTM to terminate a user address space. 


Entry from: IKTCASOO 
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-_ —_ 2 aw Ob Be ee ee 2 oe on oe ew oe 


Register 13: Address of register save area 
Register 14: Return address 
Register 15: Entry peint address 


Fxit to: IKTCASOO 


Register 13: Address of register save area 
Register 14: Return address 
Register 15; Entry fceint address 


External References: IKTCAS33, system-initiated cancel routine 


i oe ee ee oe ee ee eo oe oe a ee 


ASCB, CVT, TCAST, TWAR 


a) 
oO 
=) 
ct 
an | 
?) 
_ 
tw? 
~ 
o 
O 
~~ 
n 
CS 
n 
o 
Os 


Mapping Macros Used: CVT, IHAASCB, IKTCASWA, IKTTCAST 


Executable Macros Used: cCALLR/TM, FREEMAIN, GETMAIN, HMODESET 


ee ee ee ee oe ee i ee a oe 


Mcdule Attributes: Serially reusable 


ae ee pe ee ee et ee ee oe 


Lcock Dependency: None 


— oe ee —_——_ 


a ee oe ee oe ee ee ee ee oe ee ee a ee ee ee oe oe 


— ew = = 


Assembly Module: IKTCAS33 
Okject Module: IKTCAS33 
Alternate Entry Points: Nene 
Lead Module: IKTCAS3C 


HC Diagram: 6.2 


Function: This routine adds TSEs to the TSO/VTAM TSB chain. It also 


crtains the ASCB addresses of all TSO/VTAM users. 


Entry from: IKTCAS31 (to chain a TSB) or IKTCAS32 (to obtain ASCB 
acdresses) 


—— ee ee ere ee ee ee ee oe ee ee ee ee ae 


Register 8: Function code (in hex): 


31 Chain a TSB 
32 Obtain ASCB addresses 


Register 9: 
Address of TSB (if function code 31) 


OL 
Address of storage for ASCB addresses (if function code 32) 


Register 11: Address of TWAR 

Register 13: Address cf register save area 
Register 14: Return address 

Register 15: Entry Fcint address 


Exit to: Caller 


Reyister 8: Function code (in hex): 


31 Chain a TSB 
32 Obtain ASCB addresses 


Register 9: 


Address of TSB (if function code 31) 
or 
Address of storage for ASCB addresses (if function code 32) 


Register 11: Address of TWAR 

Register 13: Address of register save area 
Register 14: Return address 

Register 15: Entry point address 


External References: Ncne 


Ccntrol Blocks Used: CVT, PSA, TCAST, TSB, TSBX, TWAR 


-_ oe = oe OF oe oe Oe PP ee 8 oe oe oP oe oe 


Mapping Macros Used: CVT, IHAPSA, IKJTSB, IKTCASWA, IKTTCAST 


Executable Macros Used: SETLOCK 


_— =~ ow a ee ee oe Ow Oe 6 oe ee oe Oe ow 8 oe ™ ee oe 


Bcdule Attributes: Serially reusable 


Lock. Dependency: None 


Atend Codes: None 


Lata Sets: None 


Assembly Module: IKTCAS4O 
Object Module: IKTCAS40O 
Alternate Entry Pcints: 
Load Module: IKTCAS40 


Nc Ciagram: 6.3 


eer ae = = a = 


Function: This routine frocesses work element queues for the conscle 


communication subtask by giving control to routines indicated by work 
element function codes. 


Entry from: IKkTCASOO 
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Register 1: Address of TWAR 


Register 13: Address of register save area 
Register 14: Return address 
Register 15: Entry foint address 


Exit to: IKTCASOO 


4 me ee ee ee ee ee ee oe eo oe oe 


Register 1: Address of TWAR 

Register 13: Address of register save area 
Register 14: Return address 

Register 15: Return code: 


00 Normal return 


External References: IKICAS41, IKTCASH2, IKTCAS5S6 


Control Blocks Used: CIE, CSCE, TWAR 


ee ee ee ee ee ee ae 


Mapping Macros Used: IEECHAIN, IEZCIB, IKTCASWA 


oe a ae. ee ee eee 


Executable Macros Used: FREEMAIN, GETMAIN, MODESET, POST, WAIT, WTO 


ewe ee ee ee i ee ees oe 


Mcdule Attributes: Serially reusable 


ee ee ee ee ee a 


Leck Dependency: None 


-_— 2 ee ee oe — 


Abend Codes: None 


ne ee a ee ee ee ee ee 


Tata Sets: None 


ee ec ee ee ee ee ee ee ee ee a —- <n oe eee ee ee ee ee 


Assembly Module: IKTCAS41 
Object MOdule: IKTCAS41 
Alternate Entry Points: None 
Load Module: IKTCAS40 


MC Ciagram: 6.3 


Function; This routine handles work elements on the STOP queue by 


ruilding a set of work elements for the synchronous gueue, Causing an 
crderly shutdown of TCAS. 


Entry From: IKTCAS4&0O 


_——~ — ee es ee ee oe ee 


Register 11: Address of TWAR 

Register 13: Address of register save area 
Register 14: Return address 

Register 15: Entry fcoint address 


Exit to: IKTCAS4O 


we ow op oe 
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Registers_at_Exit: 


Register 11: Address of TWAR 

Register 13: Address of register save area 
Register 14: Return address 

Register 15: Return code: 


00 Normal return 


External References: IKTCAS56 


Ccntrol Blccks Used: MTCAST, TWAR 


Mapping Macros Used: IKICASWA, IKTTCAST 
Executable Macros Used: FREEMAIN, GETMAIN, POST, WAIT, WTOR 


Module Attributes: Serially reusable 


Leck Dependency: None 


Messages: IKTO10I, IKTO16D 


== «= oh ae ——o_ 


Aktend Codes: None 


Assembly Module: IKTCAS42 
Object Module: IKTCAS42 
Alternate Entry Pcints: #&ene 
Load Module: IKTCAS4O 


MC Diagram: 6.3 


Function: This routine handles work elements on the MODIFY queue by 


building a set of work elements for the synchronous queue, causing TCAS 
to be modified. 


Entry from: IKTCAS4O 


_=—- ae ow a ee a oe a 


Register 11: Address cf TWAR 

Register 13: Address of register save area 
Register 14: Return address 

Register 15: Entry foint address 


Exit _to: IKTCAS4O 


Register 11: Address of TWAR 

Register 13: Address of register save area 
Register 14: Return address 

Register 15: Return code: 


00 Hormal return 


External References: IKTCAS5S6 


DP eae Ee ante HE AE es ee a ce ee ei 
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Control Blocks Used: TCAST, TWAR 
Napping Macros Used: IKICASWA, IKTTCAST 
Executable Macros Used: FREEMAIN, GETMAIN, POST, WTO 


a ee we ew oe ow oe oe oe oe oe ow oe oe oe we om ee oe ow 


Module Attributes: 


Serially reusable 


Icck Tependency: None 
Messages: IKTOISI 
Akend Codes: None 
Lata Sets: None 
IKTCASS1_--_Initializaticn Routine 
Nages: 
Assembly Module; IKTCASS1 
Chject Module: IKTCAS5S1 


Alternate Entry Points: Ncne 


Load Module: IKTCAS51 


6.0 


Function: This routine allocates storage 


and establishes the addressability of all 


IKTCASOO 


Register 1: Address of TWAR 
Reyister 13: Address of register save 
Register 14: Return address 
Register 15: Entry foint address 
Exit te: IKTCASOO 


_—— oe ee oe oe oe ee we oe oe oe ow oe oe 


Register 1: Address of TWAR 

Register 13: Address of register save 

Register 14: Return address 

Register 15: Entry foint address 
External References: IKTCAS52, IKTCASS3, 
Ccntrol_ Blocks Used: TWAR 
Bapping Macros Used: IKICASWA 


Executable Macros Used: GETMAIN 


—_ ee we ow oe ae ee ee oe ee ee ee ee ee 


Module Attributes: 


ee ee re ee ee ee ee ee ee ee 


Serially reusable 


None 


ee - a —_ — 


IKTOO2I, IKTO12D 
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for and initializes the TWAR, 


TCAS routines. 


area 


area 


IKTCAS5S4, IKTCAS5S, 


IKTCAS56 


(* 


> me ae Ah Ss ome GE Oe Cee oem a GD GD > cep ee ee oe ee ee ee ee a ee ee 


oo or 


Assembly Module: IKTCAS52 
Object Module: IKTCAS5S2 
Alternate Entry Points: Nene 
Lead Module: IKTCAS51 


MC_Ciayram: 6.0 


Function: This routine frovides an SVC dusp if the systea operator 


—_ oe oe oe a ee a ow 


requests one. It also detaches subtasks and frees terminal transfer 
requests. 


Entry from: IKTCASOO (ncrmal) or IKTCAS5S (error) 


_ =» an ee ee ee ee ee ss ee ee ee 


Rejyister 1: Request code: 


01 Provide SVC dump. 
02 Detach subtasks 
04 Pree cross-mempory requests 


Register 10: Address of a work element 
Register 13: Address cf register save area 
Register 14: Return address 

Register 15: Entry fcint address 


Fxit to: Caller 


Register 1: Request code: 


01 Provide SVC dump 
02 Detach subtasks 
04 Pree cross-mepory requests 


Register 10: Address of a work element 
Reyister 13: Address of register save area 
Register 14: Return address 

Register 15: Entry point address 


External References: None 


<P ee ee ee we ee ee ee ee ee ee ee ee oe ow 


Ccontrol Blocks Used: CVI, TCAST, TWAR 


Mapping Macros Used: CWT, IKICAS®A, IKTCAST 


Executable Macros Used: DETACH, FREEMAIN, POST, SDUMP, WAIT, WTOR 


_— — oe oe we -_—a—_ 
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2 oe ee oe oe oe ee we ee oe ee ee ee ee es a ee a oe SD a es a es 


Assembly Module: IKTCAS53 
Object Module: IKTCAS53 
Alternate Entry Points: Necne 
Load Module: IKTCAS51 


MC DCiagram: 6.0 


Function: This routine allocates storage for and initializes the TCAST. 


Entry from: IkTCASOO 


Register 11: Address cf TWAR 
Register 13: Address of register save area 
Register 14: Return address 

Register 15: Entry foint address 


Fxit te: IKTCASOO 


: Address of TCAST 


Reyister 1 

Register 13: Address of register Save area 
Register 14; Return address 

Register 15: Return code (in hex): 


00 Normal return 
04 Invalid START cosmand 
1¢ No storage available in the CSA 


External References: Ncne 


— oo = oe om oP om a8 ee ow we ee oe Ow ee oe ae 


Control Blockes Used: CVT, TCAST, TWAR 


> we wee ew ie nee ee ee ee ee ee ee ee ee ee 


Bapring Macros Used: CVT, IKICASWA, IKTTCAST 


EFxecutable Macros Used: FREEMAIN, GETAMIN, LOAL, MODESET 


— ae ee ee om eee ee ee oe oe oe om oe oe ee ow ee oe oe 


en atm ae owt ee cee oe aD a > me owe a a oe oe eee 


Lock Dependency: None 


Messages: None 


Atend Codes: None 


LCata Sets: None 


Assembly Module: IKTCAS5S4 
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Object Module: IKTCAS5S4& 
Alternate Entry Points: Nene 
Lead Module: IKTCAS51 


Functicn: This routine validates and processes START and MOLIFY conmalr 


~~ ae 2 oe a a ow ae 


Register 9: Address of input options list 
Register 11: Address of TWAR 
Register 13: Address of register save area 
Reyister 14: Return address ; 
Register 15: Entry fcint address 


Exit to: IKTCASOO 


Register 9: Address of input options list 
Register 11: Address of TWAR 

Register 13: Address of register save area 
Register 14: Return address 

Register 15: Return code: 


00 Normal return 
04 Input options list error 


External References: IKTCAS56 


Ccntrol Blocks Used: CIE, CSCE, DCB, JFCB, TCAST, TWAR 


ap we = OP 2 2 ee a Oe ip Ow oe oe eo oe eee 


Bapping Macros Used: IEECHAIN, IEFJFCBN, IEZCIE, IHADCB, IHADCBDF, 
IKTCASWA, IKTTCAST 


Fxecutable Macros Used: CLOSE, FREEMAIN, GET, GETMAIN, OPEN, POT, 


a a es ae a eS ee 9 ee 8 ee oe oe 


CELIT, RDJFCB, RETURN, WTO 


Bodule Attributes: Serially reusable 


— = a wm ae oe ee oe ee ae > ow oe a 


Lock Dependency: None 


Bessages: IKTO13I, IKTO14I, IKTOI7I, IKTO1S8I 
Akend Codes: None 


Cata Sets: None 


ee ee ee ee cee ee es ee oe ee ee eee es ee a oe ee ee oe oe ot a ae 


Assembly Module: IKTCAS55 
Okject Module: IKTCAS55 
Alternate Entry Points: None 
Load Module: IKTCAS51 


MC _Ciagram: €.0 


—— ee a a a — = 
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Functicn: This routine provides recovery facilities for TCAS. If 


Fasses control back to RyTM for cleanup or retry, it creates work 


elements to reattach subtasks, 


— = = a aoe 


R/T 


a ee ee wet ee ee ei ee oe ee ee ee ee os ee 


Alternate Entry Points: 


Lead Module: 


EC Diagram: 


Fun 


ction: 


None 


This 


or it creates a work element to end 


Register 0: Code X'12" (if no SDWA supplied by R/TS) 
Register 1: Address of SCEWA (if SDWA supplied by R/TH) 
Register 2: Address of parameter passed from ESTAE macro (if no 
SDWA suprlied by R/TM) 
Register 13: Address cf register save area 
Register 14: Return address 
Register 15: Entry pcint address 
Exit_to: R/TM 


Register 0: Code X'12" (if no SDWA supplied by R/TB) 
Register 1: Address of SDWA (if SDWA supplied by R/TS&) 
Register 2: Address of parameter passed from ESTAE macro (if 
no SDWA supplied by R/T#) 
Register 13: Address of register save area 
Reyister 14: Return address 
Register 15: Entry point address 
External References: IKTCAS56 
Cotnrol_ Blocks Used: TWAR 
Bapping Macros_Used: IKTCASWA ‘ 2 
Fxecutable Macros Used: FREENAIN, GETMAIN, RETURN, SETRP, WTO 
Bodule Attributes: Reenterable 
Lock_Dependency: None 
Bessages: IkTO20I 
Arend Codes: None 
Tata Sets: None 


a a ee ee ee a a ee 


Names: 
Assembly Module: IKTCAS56 
Ckject Module: IKTCAS56 


Ncne 


IKTCAS51 


routine provides the message text and the list fore 


of the WTO or WTOR macro for TCAS routines that issue messages. 
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Register 1: Message number 

Register 13: Address of register save area 
Register 14: Return address 

Register 15: Entry point address 


Fxit te: Caller 


Register 1: Address of storage that contains the message length 
and the message, or zero if an invalid message number 

Register 13: Address of register save area 

Register 14: Return address 

Register 15: Entry fcint address 


External Refernces: None 


Ccntrol Blocks Used: Ncne 


—_ one aw a ae ow ow oe oo 


Executable Macros Used: WTO, WTOR 


Module Attributes: Reenterable 


Lock Dependency: None 


=~ a oo om o> om ow ee A a a a 


Messages: Contains all TCAS sessages 


— ean = oe ee 


Atend Codes: None 


[Tata Sets: None 


Object Module: IKTINX1 
Lead Module: IKTCAS20 


Function: An installaticn must write this routine if it wants to use 

a terminal not supported by TSO/VTAS. IKTCAS23 calls IKTINX1, if 
Ercovided, when a logon request is encountered from a tergpinal other 
than an IBM 3270, 3767, cr 3770. IKTINX1 must verify that the terpinal 
is supported by installation-written routines (that is, a terpinal 
input manager, a terginal outfut manager, and edit routine IKTGETXT), 
and it must set the terminal type (to a value other than XtO1* or X!02°) 
and the buffer size. 


—=—_— = = oe a a em of a= ow a oP oe 


Register 1: Address of a parameter list containing: 


° Address of the RPL 
° Address of a Eyte fcr indicating terminal type 
e Address of two bytes for indicating terminal buffer size 
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Register 13: Address of register save area 
Register 14: Return address 
Register 15: Entry foint address 


Exit to: IKTCAS23 


ee ol ae OP oe > oe ee ae ee > a oe 


Register 15: Return code: 


00 Recognized terminal type; logon processing will ccntinue 
Q4 Unrecognized terminal type; logon processing will terminate 
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TCAS DIRECTORY 


This section shows the relaticnship between TCAS load module and object 
macdule nages. It also shows which HIPO diagram (in "TCAS Nethod of 
Cperation") is associated with each object module, and whether the 
mecdule has a program organization description (in "TCAS Progran 
Crjanization"). 


There are three coluagnns: 


e Load module name, object module name - Load module names appear 
farthest to the left. Indented under each load nodule natie are the 
names of the object modules contained in the load module. Assesbly 
module names are the sape as the object module names. There are no 
alternate entry points in any TCAS modules. 


e MO Diagram - The identification nuaber of the HIPO diagram (in "TCAS 
Method of Operation") in which the function corresponding to each 
chject module is described. 


e PO Description - An indication (X) as to whether there is a 


description in “"TCAS Programs Organization" associated with each 
crEject module. 


TCAS Directory 169 


cf 
| Load Module Nane { MO {| PO | 
| Okject Module Name | Ciagrar { Description i 


en  _ 


| IKTCASOO | { | 
{ IKTCASOO { 6.0 ] x | 
1 IKTCASS1 { I | 
[ IKTCAS51 | 6.0 { » ¢ | 
| IKTCASS2 | 6.0 { xX \ 
IKTCAS5S3 { 6.0 i x | 
{ IKTCASS4 | 6.0 i x i 
| IKTCAS55 | 6.0 | X | 
| IKTCAS56 | None { x | 
[SS Se ee ee ee re { 
| VTAM Interface Subtask | 
en et ee ee ee i] 
{| IKTCAS20 j I l 
IKTCAS20 i 6.1 { xX | 
i IKTCAS21 | 6.1 { X ; 
| IKTCAS22 { 6.1 | x 
| IKTCAS23 i 6.1 | x | 
| IKTCAS24 | 6.1 j x | 
| IKTCASCX | 6.1 | X | 
| IKTCASOX { 6.1 | x | 
| IKTINX1 | 6.1 i xX | 
a er ee ae oe ee ea ee ee ee a ee ee j 
{ User Interface Subtask | 
Se a ee eae ig pee a eg eee oe eg on er ee { 
{ IKTCAS3O | | | 
( IKTCAS 30 | G.s2 | xX H ; 
| IKTCAS31 { 6.2 | x { 
| IKTCAS32 | 6.2 i x { 
| IKTCAS33 | 6.2 | x | 
] IKTCASX1 i 6.2 j x j 
re re eas a eee ee I 
| Console Ccmmunication Subtask | 
a ce ee ee ee we ne cee we ee te ee ee ee ee ee ee re ee oe ee ew ee ae a en ee a ee es | 
! IKTCAS4O | { { 
{ IKTCAS4O | 6.3 { x | 
| IKTCAS41 | 6.3 | x | 
[ IKTCAS42 j 6.3 j x 1 
J 
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This section provides information about TCAS data areas. It contains: 
e A TCAS control block overview (Figure 13) 
e A description of a work elesent 


LTescriftions of the control blocks used by TCAS can be found in OS/VS2 


and in OS/VS2 Systeg Data Areas, SYB8-0606 (microfiche). 

A cress reference between data area names and TCAS object modules that 
use them is contained in the system data area usage table sicrofiche, 
CSZVS2 Data Area Usaye Table, SYB8-O742. A list giving the names of 
data area fields and the TCAS object modules that update them is 
ccntained in the system symbol usage table microfiche, OS/VS2 Symbol 
Usage Table, SYB8-O744. 
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CVT 


1012 
(3F 4) CVTTCASP 


TCASTSB 


(44) (4 first TSO/VTAM TSB 


Synchronous queue 


4 


TWAR 
(4) TWASYNOH 
12 
(C) TWAASCB 
CSCB 
16 ; 
(10) TWACSCB : 
20 
14) TWATCAST 
TPEND queue 
288 
(120) TWAVTEQH | 
292 
(124) TWAVTHQH 
296 ACB8 control queue 
(128) TWAVACOH al 
(194) TWAUACQH 
on STOP 
(200) TWACSTPQ queue 


516 
(204) 


TWACMODQ 


Figure 13. TCAS Ccntrol Block Overview 


172 


60 
(3C)] TCASWA 
TCASASCB 
(68) | TCASTTQH 


TSB chain 


dt 


Global terminal ha.:dling queue 


I 


y ASCB 


Loca! terminal handling queue 


J 


Address space create queue 


J 


MODIFY queue 


J 


A work elegwent (see Figure 14) represents a unit of work to ke performed 
ty TCAS. Each work element has primary and secondary task and function 
ccedes. The primary task code indicates which TCAS task should perfora 
the function indicated by the primary function code. The secondary 
task code specifies which task should be dispatched when the prisary 
task is unable to complete its work. The field containing the address 
cf the next work elegwent provides a means of queving work elements. 

The entry code/return code field is sometimes used for intertask 
coagunication. The basic work element is 12 bytes long; if a variable 
length work element is used, the length field will have a value greater 
than 12. Variable work elements are mapped by IKTWESTD. 


A list of task codes and function codes appears below. Function codes 
marked with an asterisk (*) are used only for error recording and 
identification (see "TCAS Diagnostic Aids"); their functions are not 
Erecessed as work elements. 


Task Code Functicn Code 
JShexadeciaal) hexadecimal) Function 


01 TCAS main task (IKTCASOO) 
10 START comamand processing (IKTCASOQO) 
*20 Call TCAS initialization routine 
IKTCAS51 
* 30 Call TCAST creation routine 
IKTCAS53 
*h0 Call parameter processing 
scanner IKTCASS5S4 
50 Attach VTAM interface subtask 
driver IKTCAS20 
60 Attach user interface subtask 
driver IKTCAS30 
70 Attach console comsfunication 
subtask driver IKTCAS4O 
80 Call TCAS termination routine 
IKTCAS5S2 
91 End of task (IKTCASOOQ) 
92 TCAS main task akend (IKTCASOO) 
*AO Wait routine (IKTCAS0Q) 
FF Return 
02 VTAM interface subtask (IKTCAS20) 
*01 VTAM interface initialization 
(IKTCAS20) 
#02 Route control (IKTCAS20) 
03 End of task (IKTCAS20) 
11 ACB control - open ACB (IKTCAS21) 
12 ACB control - close ACB 
(IKTCAS21) 
13 ACB control - guiesce logons 
(IKTCAS21) 
14 ACB control - start logons 
(IKTCAS21) 
21 Terminal handling - transfer 
terminal (IKTCAS22) 
22 Terminal handling - release 
terminal (IKTCAS22) 
#23 Terminal handling - free 
terminal control blocks 
(IKTCAS22) 
*31 Logon processing ~ initial 
terminal processing (IKTCASOX) 
*32 Logon processing - request 


address space (IKTCASCX) 
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Task Code Function Code 


oh an eee ee oe oe a a — a a oe oD ee 


41 
FF 

03 
*01 


*02 
03 
11 
21 
22 
31 
32 


FF 
04 


*01 


*02 
03 
11 
21 
FF 


4(4) 
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0(0) 1(1) 2(2) 3(3) 
Primary task code Primary function code Secondary task code Secondary function code 


next work element 


8(8) 10( A) 
Entry code or return code 


Figure 14. A TCAS Work Element 


Function 


TPEND (IKTCAS24) 

Return 

User interface suktask (IKTCAS30) 
User interface initialization 
(LKTCAS30) 

Route control (IKTCAS30) 

End of task (IKTCAS30) 

Address space creation (IKTCAS31) 
Address space termination - system 
initiated cancel (IKTCAS32) 
Address space termination - CALLR/TM 
(IKTCAS32) 

TSB manipulation ~- chain TSB 
(IKTCAS33) 

TSB manipulation - extract ASCB 
address (IKTCAS33) 

Return 

Console communication subtask 
(IKTCAS4O) 

Console communication initialization 
(IKTCAS4O) 

Route control (IKTCAS&O) 

End of task (IKTCAS4QO) 

Process STOP command (IKTCAS41) 
Process MODIFY command (IKTCAS42) 
Return 


Length of work element 
(12 bytes if not variable) 


er ee ae a a oe oe ae 


This secticn contains information that can be used to diagnose TCAS 
problems. It contains: 


e A message list containing the names of object modules that detect 
the conditions reguiring messages, issue the gpessages, and contain 
the message text 


e An abend code list ccntaining the name of an object module that 
detects the condition requiring an abend code and issues the code 


e A description of TCAS error recording 
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Bessages ) 


The following mesSages are issued by TCAS object modules. For 


explanations of the messages see OS/VS Message Library: 
For explanstions of the terminal messages, see 


GC38-1002. 


— a — a oe we oe —_— ee ee oe —_o_ eae eee ee ee oe eee: 


VS2 Systea 


Message Module Module Module 
Ee Detecting Issuing Containing 
IKTOOID IKTCASOO IKTCASOO IKTCAS5S6 
IKICO2I IKTCASOO IKTCASOO IKTCAS5S6 

IKTCAS5S1 IKTCASS1 IKTCAS56 
IKTOQO3D IKTCASOO IKTCASOO IKTCAS56 
IKTOO4D IKTCASOO IKTCASOO IKTCAS56 
IKTCOSI IKTCASOO IKTCASOO IKTCAS5S6 
IKICO6I IKTCASOO IKTCASOO IKTCAS5S6 
IKTOO7TI IKTCAS21 IKTCAS21 IKTCAS56 
IKTOOS8I IKTCAS21 IKTCAS21 IKTCASS6 
IKTOO9I IKTCAS24 IKTCAS24 IKTCASS6 
IK1C101 IKTCAS41 IKTCAS41 IKTCAS56 
IKTO11I IKTCAS4O IKTCAS4O IKTCAS56 Jo 
IKTO12L0 IKTCAS51 IKTCAS51 IKTCAS5S6 
IKTO131 IKTCAS54 IKTCASSY IKTCASS6 
IKTO14I IKTCASS4 IKTCAS54Y IKTCAS56 
IKTC15I IKTCAS82 IKTCAS4&2 IKTCASS6 
IKTOI6C IKTCAS41 IKTCAS41 IKTCAS56 
IKTO171 IKTCASS4 IKTCAS5S4 IKTCAS5S6 
IKTO18I1 IKTCASS4Y IKTCASSS& IKTCAS56 
IKTO191I IKTCASCX IKTCASCX IKTCAS5S6 

IKTCASOX IKTCASOX 

IKTCAS23 IKTCAS23 
IKTO20I1 IKTCAS5S5 IKTCASS55 IKTCAS56 
Terminal Nessages 
Message Module Mcdule Module 
Sane Detecting Issuing Containing 
IKTCO201I IKTCAS31 IKTCAS31 IKTCAS56 
IKTOO202I IKTCAS31 IKTCAS31 IKTCAS5S6 
IK1C0203I IKTCAS31 IKTCAS31 IKTCASS6 
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The following akend code i 


1s issued by TCAS. n explanation of the 
cede, see OS/VS Message Library: 


For a 
VS2 System Codes, GC38-1008. 


Module Module 


wee a a ee ee ee —- oe ee ae ae 


Each TCAS task has a corresponding segment in the TCAS work area (TWAR) 
fcr recording errors. The segments are initialized to zero. When each 
routine of a task begins execution, the function code, retry address, 
and register save area address of the routine are stored in the task's 
fcctprint area (TWAME, TWAVE, TWAUE, or TWACE). Each footprint area 

is 32 bytes long; each fcotprint is eight bytes long (function code-1 
tyte, retry address-3 bytes, register save area address-4 bytes). A 
fcctfprint is stored in the first ncnzero eight bytes of a fcotprint 
area. When a routine finishes processing, it resets its footprint to 
zero. 


When a TCAS task abnormally terminates, the function code corresponding 
tc the function being performed at time of abend is stored in the abend 
recording area (TWAMABFC, TWAVABFC, TWAUABFC, or TWACABFC) of the 
akending task. Because a TCAS task is not allowed to abend more than 
twice, only the first 2 bytes of any TCAS task's abend recording area 
are used. 


When a TCAS routine fails, before R/TM gets control, the function code 
corresponding to the function keing performed at time of failure is 
stored in the retry recording area (TWAMRTFC, TWAVRTFC, TWAURTFC, or 
IWACRTIFC) of the task executing the failing routine. The task 
terminates if retry is attempted twice. 


Ncte: A list of TCAS function codes appears in "TCAS Data Areas." 
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ACE Access method contrcl block 

ASCE Address space control block 

ASCII American naticnal standard code for information 
interchange 

ASVT Address space vector takle 

ATTN Attention 

CIB Command input buffer 

cIC Communications identifier 

CMS Cross memory services 

CSA Compson service area 

CSCB Command scheduling control block 

CVT Communications vector table 

EBCLDIC Extended binary coded decimal interchange code 

ECE Event control block 

EXLST Exit list 

FME Function management end 

FER Functional recovery routine 

FRRS Functional recovery routine stack 

HIEO Hierarchy plus input-process-output 

IPARHS Input queve farameters 

IBE Interruption reguest block 

LE Logoo buffer 

BO Method of operation 

NIE Node information block 

OFARMS Output gueue farameters 

EC Program organization 

PSA Prefixed save area 

CVPL Queue verification parameter list 

RE Request block 

RMEFL Resource manager parameter list 

RPL Request parameter list 

RU Request unit 

R/TH Recovery/terpination management 

SCYT Secondary communications vector table 

SCWA System diagnostic work area 

etc Systea-initiated cancel 

SRB Service request block 

SRM System resources manager 

SVRE Supervisor reguest kLlock 

ICAM Telecoamunications access sethod 

TCAS Terminal control address space 

ICAST TCAS table 

TCE Task control LElock 

ICT Tiging control table 

TCXD TCAM CVT extension 
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T1Is Terminal input manager 


TIMWA Terminal input manager work area 
TIOC Terminal I/0 ccordinator 

TIOCRPT TIOC reference pointer table 

ICS Terminal output manager 

ITOMWA Terainal output manager work area 
TSB Terpinal status block 

TSEX TSB extension 

Tvcs TSO/VTAM CSA area 

IVWA TSO/VTAM work area 

TWAR TCAS work area 

USS Unformatted system services 

VIAM Virtual teleccumunications access sethod 
VTIOC VTAM terminal I/O coordinator 

WE Work element 

WESTE Standard work element 

WSAVT Work/save area vector table 

XSA Extended save area 
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VIIOC and TCAS code contains hcoks to exit routines that can be written 


> AD EE cee ee SE OE A eS aD ane Ge ee eee a ee eee es -_ sense > ba ae a a oe as 


ty an installation to: 


The exit routines are oftional. 
must be link-edited with the okject module that calls it. 
aFFropriate points during VTICC and TCAS processing, a check is made 
to determine if a particular exit routine exists. 
Called; if it does not exist, 


IBM-supplied editing. 


Perform attention handling that replaces IBM-supplied attention 


handling. 


Provide support for record mode terminals not supported by TSO/VTAM. 
(Note that an installation must write its own terminal input manager 
and terminal output manager, in addition to exit routines IKTGETXT, 
IKTINX2, and IKTINX1, in order to support record mode terminals not 
supported by TSO/VTAM. Also note that the IBM-supplied IyO managers 


have a record mode interface to VTAB.) 


The exit routines are summarized below. 


e Perform input and output editing that replaces or supplements 


At 


If it exists, 
normal processing continues. 


Frcevided in "VTIOC Program Organization" and "TCAS Program 
Crganization." 


= ee Oe Oe ee oe eee ee eee ee eee eee eee eee eee eee eee 


IKTCASX1 
IKTGETXT 
IKTIDSX1 
IKTIDSX2 
IKTIDSX3 
IKTIDSX4 
IKTICSX5 
IKTINX2 
IKTRTX1 
IKTRTX2 
IKTRTX3 


IKTRTX4 
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Replace or supplement IBM- 
supplied output editing 
Edit input data 


Replace or supplergent IBA- 
supplied output editing 
Supplement IEM-supplied 
input editing 

Replace IBS-supplied 
attention handling 

Replace or supplesgent IBHM- 
supplied input editing 
Replace IBM-supplied 
attenticn handling 
Initialize installation- 
written I/O managers 
Replace or supplement IBM- 
Ssufflied output editing 
Supplement IBM-supplied 
input editing 

Replace IBMS-supplied 
attention handling 

Replace or supplement IBM- 
supplied input editing 


Non- | 
supported | 
Non- | 
supported | 
3270 


3270 


[ 

I 

l 

I 

3270 (LUO) | 
\ 

3270 [ 
I 


3270 (LU2) | 
i 


Non- I 
supported | 
3767/3770 

( 
3767/3770 

l 
3767/3770| 


3767/3770| 
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IKTCAS31 
IKTVTGET 
IKT32700 
IKT32701 
IKTIMIDS 
IKTVTGET 
IKTINLU2 
IKTXINIT 
IKTTOMRT 
IKTTIMRT 
IKTTIORT 


IKTVTGET 
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Before an exit routine can be used it 


More detailed descriftions, 
including the function of each routine and required linkages, are 


| j | Tergwinal | 


{| Nawge } Purpose | Type | Caller | 
a a aaa a aaa a ae aa | 
| TCAS | 
| IKTINX1 | Set terminal type and buffer | Non- | IKTCAS23 | 
| | size {| supported] | 
bye ee ee a a ee J 
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abbreviations 179 
ABEND codes 
TCAS 177 
VfTIoc 133 
ACB (access aethod control block) 
allocation and initialization 7 
in YTIOC control block overview 124 
ACB control queue 
creation 141 
in TCAS control block overview 172 
address space create queue 
in TCAS control block overview 172 
processing 142 
ASCB (address space control block) 
allocation and initialization 134 
in TCAS control block overview 164 
ASCII data 
conversion to EBCDIC 27,31 
attention handling 40 
(see also IKTATTN) 
attention interruption 
receiving 26,32 
sending 28,33 
automatic character proapting 
halting 59 
restarting 60 
sending 28,33 
setting 58 
automatic line nusbering 
halting 59 
restarting 60 
sending 28,33 
setting 56 


branching, terminal control macro 52 
breakin, setting 54 
BUFRSIZE value 8 


calling address space TPUT with ASID 
routine 23 
(see also IKTASTPT) 
CALLRTH macro 142 
cancel command 30 
cancellation of user address space 142 
character proapting, automatic 
halting 59 
restarting 60 
sending 28,33 
setting 58 
Character translation 
On input 27,31 
on output 28,33 
with STTRAN macro 61 
CLEAR key 26 
Clearing queue 53 
closing of ACB 13,140 
CLSDST macro, issued 8,12,13,14,141 
codes, ABEND 
TCAS 177 
¥WTIOC 133 


cogamand processor, in TCAS Console 
Comjaunication MO diagram 144 
console communication, TCAS 144 
control blocks, overview 
TCAS 172 
VTIOC 124 
control flow, module to nodule 
TCAS 146 
VTIOC 67 
converting data 
ASCII to EBCDIC 27,31 
EBCDIC to ASCII 28,33 
user-specified 27,31 
creation of user address space 142 
cross-pemory TPUT, sending 23 
CSCB (command scheduling control block) 
in TCAS control block overview 172 
CVT (communications vector table) 
in TCAS control block overview 172 
in YTIOC control block overview 124 


data areas 
TCAS 171 
VTIOC 123 

directory 
TCAS 169 
WTIOC 119 


EBCDIC data 
conversion to ASCII 28,33 
editing 
on input 20,27,31 
on output 22,23,28,33 
ESTAE routine for SVC 93 (IKT93EST) 25 
exit routines 
Bind (IKTCASOX) 141 
ESTAE (IKTCAS5S5) 138 
installation-written 181 
logon (IKTCAS23) 141 
LOSTERM (IKTLTERM) 14 
OPNDST RPL (IKTRPLXT) 10 
release/pass (IKTCASCX) 141 
TPEND (IKTCAS24) 140 
EXLST (exit list) 
allocation and initialization 8 
in VTIOC control block overview 124 
extended logoff routine 13 
(see also IKTLOGFF) 
extended logon routine 11 
(see also IKTXLOG) 


flashback line, sending 28 
PRR routines 

IKTIAPRR 31 

IKTIOFRR 43 

IKTOMPRR 29,33 

IKTQMPR1 48,51 

IKTQMFR2 48,51 

IKTXMFRR 24 
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global terminal handling queue 
creation 17 
freeing 16 


in TCAS control block overview 172 


processing 140 


I/O manager initialization routine 9 
IEAVEQV3 

in IKTQMIN MO diagram 48 

in IKTQMOUT MO diagram 51 
ITEDAYS 

in control flow 67 

in IKTAY81 MO diagram 16 

in IKTAY82 MO diagram 17 

in IKTAY83 MO diagram 18 
IGco001Cc 

in directory 119 

in IKTAY8 PO description 76 
IGco00g9c 

in control flow 68 

in directory 120 

in IKTASTPT MO diagraa 23 

in IKTASTPT PO description 73 

in IKTGETXT PO description 77 

in IKTIDSX4 PO description 79 

in IKTRTX4 PO description 94 

in IKTVTGET MO diagram 20 

in IKTVTGET PO description 98 

in IKTVTPUT MO‘ diagram 22 

in IKTVTPUT PO description 99 

in TGET/TPUT overview MO diagras 
IGCO0003D 

in control flow 72 

in directory 121 

in IKTO940OA MO diagram 57 

in IKTO94OA PO description 103 

in IKTO940C MO diagram 58 

in IKTO940C PO description 104 

in IKTO94OD MO diagram 59 

in IKTO940D PO description 105 

in IKTO94OF MO diagram 60 

in IKTO94OE PO description 106 

in IKTO94OF MO diagram 61 

in IKTOQ94OF PO description 106 

in IKT09401 MO diagram 53 

in IKT09401 PO description 108 

in IKTO9404 MO diagram 54 

in IKT09404 PO description 109 

in IKTO9405 MO diagram 55 

in IKTO9405 PO description 110 

in IKTO9409 MO diagram 56 

in IKTO9409 PO description i111 

in IKT09412 MO diagram 62 

in IKT09412 PO description 112 

in IKTO09413 MO diagram 63 

in IKT09413 PO description 113 

in IKTO9414 MO diagran 64 

in IKTO9414 PO description 114 
I1GG09301 

in TGET/TPUT overview MO diagrap 
IGG09302 

in TGET/TPUT overview MO diagran 
IKJEFLA 

in control flow 66 

in directory 120 

in IKTIION PO description 81 


184 


19 


19 


19 


in IKTINX2 PO description 83 

in IKTLOGFF PO description 84 

in IKTRPLXT PO description 92 

in IKTXINIT MO diagram 8 

in IKTXINIT PO description 99 
IKJEFLB 

in control flow 67 

in IKTLOGFF MO diagram 13 

in IKTLOGFF PO description 84 
IKJEFLE 

in control flow 66 

in directory 119 

in IKTLOGR PO description 86 

in IKTXLOG MO diagram 11 

in IKTXLOG PO description 100 
IKJEFLEA 

in control flow 66 

in IKTLOGR MO diagrap 12 

in IKTLOGR PO description 86 
IKJEFLF 

in control flow 67 

in IKTLTERM MO diagram 
IKTASCII 

in directory 120 

PO description 73 
IKTASTPT 

in control flow 68 

in directory 120 

MO diagraa 23 

PO description 73 
IKTATTN 

in directory 120 

MO diagram 40 

PO description 74 
IKTAY8 

(see also IKTAY81, IKTAY82, IKTAY83) 

in control flow 67 

in directory 119 

PO description 75 
IKTAYS1 

in control flow 67 

in directory 119 

in PO description 75 

MO diagram 16 
IKTAY82 

in control flow 67 

in directory 119 

in PO description 75 

MO diagraa “17 
IKTAY83 

in control flow 67 

in directory 119 

in PO description 75 

MO diagram “i18 
IKTCASCX 

in control flow 147 

in directory 170 

in MO diagram 141 

PO description 148 
IKTCASOX 

in control flow 147 

in directory 170 

in MO diagram 141 

PO description 148 
IKTCASX1 

in control flow 146 

in directory 170 

in installation exit sumpary 182 


14,15 


- 


> 
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in MO diagram 182 

PO description 1&9 
IKTCASOO 

in control flow 146 

in directory 170 

in MO diagram 138 

PO description 150 
IKTCAS20 

in control flow 146 

in directory 170 

in MO diagram 140 

PO description 151 
IKTCAS21 

in control flow 146 

in directory 170 

in MO diagram 140 

PO description 152 
IKTCAS22 

in control flow 146 

in directory 170 

in MO diagram 180 

PO description 152 
IKTCAS23 

in control flow 147 

in directory 170 

in MO diagram 141 

PO description 153 
IKTCAS24& 

in control flow 146,147 

in directory 170 

in MO diagraa 140 

PO description 154 
IKTCAS30 

in control flow 146 

in directory 170 

in MO diagram 142 

PO description 156 
IKTCAS31 

in control flow 146 

in directory 170 

in MO diagraa 142 

PO description 156 
IKTCAS32 

in control flow 146 

in directory 170 

in MO diagram 142 

PO description 157 
IKTCAS33 

in control flow 146 

in directory 170 

in SO diagraa 142 

PO description 158 
IKTCAS4SO 

in control flow 146 

in directory 170 

in MO diagram 142 

PO description 159 
IKTCAS41 

in control flow 146 

in directory 170 

in MO diagram 142 

PO description 160 
IKTCAS42 

in control flow 146 

in directory 170 

in MO diagram 142 

PO description 161 
IKTCAS5S1 


in control flow 146 

in directory 170 

in MO diagram 142 

PO description 162 
IKTCAS52 

in control flow 147 

in directory 170 

in MO diagram 143 

PO description 163 
IKTCAS53 

in control flow 146 

in directory 170 

in MO diagrara 138 

PO description 168 
IKTCASS4 

in control flow 146 

in directory 170 

in MO diagram 138 

PO description 164 
IKTCASSS5 

in control flow 147 

in directory 170 

in MO diagram 138 

PO description 165 
IKTCAS5S6 

in directory 170 

PO description 166 
IKTEXIT 

in directory 120 

MO diagraaz 38 

PO description 76 
IKTGETXT 

in control flow 68 

in directory 120 

in IKTVTGET MO diagram 20 

in installation exit summary 182 

PO description 77 ‘ 
IKTIDSX1 

in control flow 71 

in directory 120 

in IKTOMIDS MO diagram 28 

in installation exit summary 182 

PO description 78 
IKTIDSX2 

in control flow 69 

in directory 120 

in IKTIMIDS MO diagram 27 

in installation exit Summary 182 

PO description 78 
IKTIDSX3 

in control flow 69 

in directory 120 

in IKTIMIDS MO diagram 26 

in installation exit summary 182 

PO description 79 
IKTIDSX4 

in control flow 68 

in directory 120 

in IKTVTGET MO diagram 20 

in installation exit summary 182 

PO description 79 
IKTIDSX5 

in control flow 69 

in directory 120 

in MO diagram 34 

PO description 80 
IKTIIOMN 

in control flow 66 
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in directory 119 

MO diagram 9 

PO description 81 
IKTIMFRR 

in directory 120 

in IKTTIMRT MO diagram 31 

in IKTTIMRT PO description 
IKTIMIDS 

in control flow 69 

in directory 120 

MO diagram 26 

PO description 81 
IKTIMLU2 

in control flow 69 

in directory 120 

MO diagram 34 

PO description 82 
IKTINX1 

in directory 170 


in installation exit summary 
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in TCAS VTAM Interface MO diagram 


PO description 167 
IKTINX2 

in control flow 66 

in directory 119 

in IKTXINIT MO diagram 8 


in installation exit summary 


PO description 83 
IKTIOFRR 

in control flow 69,70 

in directory 120 

MO diagram 43 

PO description 84 
IKTIOMOO 

in directory 120 
IKTIONO1 

in directory 120 
IKTIONO2 

in directory 120 
IKTIONO3 

in directory 120 
IKTISTOO 

in directory 120 

MO diagraa 45 

PO description 84 
IKTLOGFF 

in control flow 67 

in directory 119 

MO diagram 13 

PO description 84 
IKTLOGR 

in control flow 66 

in directory 119 

MO diagram 12 

PO description 86 
IKTLTERM 

in control flow 67 

in directory 119 

MO diagran 14 

PO description 87 
IKTMSGS 

in directory 121 

PO description 88 
IKTOMFRR 

in directory 120 

in IKTOMIDS MO diagram 28 

in IKTOMIDS PO description 

in IKTTOMRT MO diagram 32 
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88 


141 


in IKTTOMRT PO description 96 
IKTOMIDS 
in control flow 71 
in directory 120 
MO diagram 28 
PO description 88 
IKTOMLU2 
in control flow 71 
in directory 120 
MO diagram 36 
PO description 89 
IKTQMEV 
in directory 120 
in IKTQMIN MO diagram 48 
in IKTQMNGR PO descriftion 90 
in IKTQMOUT MO diagram 51 
IKTQMFR1 
in directory 120 
in IKTQMIN MO diagram 48 
in IKTQMNGR PO description 90 
in IKTQMOUT MO diagram 51 
IKTQMFR2 
in directory 120 
in IKTQMIN MG diagram 48 
in IKTQMNGR PO descrirtion 90 
in IKTQMOUT MO diagram 51 
IKTQMIN 
(see also IKTQMNGR) 
in control flow 68,69 
in directory 120 
MO diagram 46 
IKTOQOMNGR 
(see also IKTQMIN, IKTQMOUT) 
in control flow 68,69,71,72 
in directory 120 
PO description 90 
IKTQMOUT 
(see also IKTOMNGR) 
in control flow 68,69,71 
in directory 120 
MO diagram 49 
IKTRPLXT 
in control flow 66 
in directory 119 
MO diagrag (410 
PO description 92 
IKTRTX1 
in control flow 71 
in directory 120 
in IKTTOMBT MO diagram 32 
in installation exit summary 182 
PO description 92 
IKTRTX2 
in control flow 69 
in directory 120 
in IKTTIMRT MO diagraa 30 
in installation exit summary 182 
PO description 92 
IKTRTX3 
in control flow 69 
in directory 120 
in IKTTIMRT MO diagram 31 
in installation exit summary 182 
PO description 94 
IKTRTX4 
in control flow 68 
in directory 120 
in IKTVTGET MO diagram 20 
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in installation exit summary 182 

PO description 94 
IKTTIMRT 

in control flow 69 

in directory 120 

MO diagraa 430 

PO description 95 
IKTTOMJR 

in control flow 71 

in directory 120 

MO diagram 29 

PO description 96 
IKTTOMRT 

in control flow 71 

in directory 120 

MO diagraa 32 

PO description 96 
IKTVTIGET 

in control flow 68 

in directory 120 

MO diagram 20 

PO description 97 
IKTVTPUT 

in control flow 68 

in directory 120 

MO diagraa 22 

PO description 98 
IKTXINIT 

in control flow 66 

in directory 119 

MO diagram 8 

PO description 99 
IKTXLOG 

in control flow 66 

in directory 119 

MO diagram 411 

PO description 100 
IKTXMFRR 

in directory 120 

in IKTXMTPT MO diagram 24 

in IKTXMTPT PO description 101 
IKTXMTPT 

in control flow 68 

in directory 120 

MO diagram 24 

PO description 101 
IKTOOOID 

in control flow 72 

in directory 121 

MO diagram 52 

PO description 102 
IKTO9GOA 

in control flow 72 

in directory 121 

MO diagram 57 

PO description 103 
IKTO94OC 

in control flow 72 

in directory 121 

MO diagram 58 

PO description 104 
IKTO9WOD 

in control flow 72 

in directory 121 

MO diagram 59 

PO description 1065 
IKTOO4OE 

in control flow 72 


in directory 121 

MO diagram 60 

PO description 106 
IKTOSNOF 

in control flow 72 

in directory 121 

MO diagram 61 

PO description 106 
IKTO9401 

in control flow 72 

in directory 121 

MO diagran 53 

PO description 108 
TKTOS4O4 

in control flow 72 

in directory 121 

MO diagram 54 

PO description 109 
IKTO09405 

in control flow 72 

in directory 121 

MO diagram 55 

PO description 110 
IKTO94O9 

in control flow 72 

in directory 121 

MO diagram 56 

PO description 111 
IKT09412 

in control flow 72 

in directory 121 

MO diagram 62 

PO description 112 
IKT09413 

in control flow 72 

in directory 121 

MO diagram 63 

PO description 113 
IKTO9N14 

in control flow 72 

in directory 121 

MO diagram 64 

PO description 114 
IKT32701 

in control flow 69,70 

in directory 120 

MO diagram 41 

PO description 115 
IKT32700 

in control flow 71 

in directory 120 

MO diagram 42 

PO description 116 
IKT9I3EST 

in control flow 69 

in directory 120 

MO diagram 25 

PO description 116 
initialization 

of ACB 8 

of ASCB 142 

of EXLST 8 

of logon buffer 141,142 

of NIB 8,142 

of pointers to ASCII translation 

tables 9 

of RPL 142 

of terminal input manager 9 
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of terminal output manager 9 
of TSB 142 
of TSBX 142 
of TVWA 8 
of TWAR 138 
of VTAM control blocks 8 
routines 
IKTIION 9 
IKTLOGR 12 
IKTRPLXT 10 
IKTXINIT 8 
IKTXLOG 11 
initialization/termination routines 
introduction 1 
module names 119 
input gueue 
allocation 8 
in VTIOC control block overview 124 
input queue element 128 
input queue manager 46 
input gueue @amager parameter list 125 
installation-written exit routines 181 
inter-terminal communication, setting 157 
IPARMS (input queue manager parameter 
list) 125 


keyboard, unlocking 26 


legend for HIPO figures 5 
line numbering, automatic 
halting 59 
restarting 60 
sending 28, 33 
setting 56 
line size, setting 57 
local terainal handling queue 
creation 143 
in TCAS contro] block overview 172 
processing 140 
logical unit, types of 3 
Lojical Unit Status command 31 
logoff processing 14,17,18 
extended logoff 13 
logon buffer 
address 11 
allocation and initialization 141,142 
in VTIOC control block overview 124 
LOGON initialization routine (see IKJEFLA) 
LOGON/LOGOFF verification routine (see 
IKJEFLE) 
logon processing 141 
extended logon 11 
loyon reconnect 12 
logon reconnect routine 12 
LOGON scheduling routine (see IKJEFLB) 
look-aside buffer 
allocation 8 
in VTIOC control block overview 124 
lost terminal exit scheduler 45 
LOSTERM exit routine 14 
LUS (Logical Unit Status) command 31 
LUQ 3 
LU1 3 
LU2 3 
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main task, TCAS 138 


messages 
TCAS 176 
VTIOC 132 


MODIFY command 144 

MODIFY queue 
creation 144 
in TCAS control block overview 172 
processing 144 


NIB (node information block) 

allocation and initialization 8 

in VTIOC control block overview 124 
null RU routine 29 


OPARSS (output queue manager parameter 
list) 126 


opening, of ACB 8,140 
OPNDST macro 

checked 10 

issued 8,114,141 


OPNDST RPL asynchronous exit routine 10 
(see also IKTRPL3T) 
output queue 
allocation 8 
in VTIOC control block overview 124 
output queue element 129 
output queue manager 46 
(see also IKTQMOUT) 
output queue manager parameter list 126 
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Parse/scan interface routine (see IKJEFLEA) 


QTIP 29 eguivalent routine (IKTAY83) 
in control flow 68 
in directory 119 
in PO description 76 
MO diagraa 18 
queue 
adding elements 
Clearing 53 
removing elements 
updating elements 
queue element 
input format 128 
output format 129 
queue manager 
introduction 1 
module names 120 
queue manager look-aside buffer 
allocation 8 
in VTIOC control block overview 124 
gueue verification 48,51 


46,49 


46,49 
46,49 


R/TS 
in TCAS control flow 146,147 
in VTIOC control flow 68 
RECEIVE macro 
in introduction 1 
issued 26,30 
reconnection of TSO/VTAM terminal 
RPL (reguest parameter list) 
allocation and initialization 8 


12,14 
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in VTIOC control block overview 
RTAUTOPT routine 60 

(see also IKTO94OE) 
RTA1 

in TCAS User Interface MO diagrap 
RTM2 

in VTIOC control flow 67 


SEND macro 
in introduction 1 
issued 28,29,32 
SPAUTOPT routine 59 
(see also IKTO94OD) 
START command 138 
started task control 
in IKTCASOO PO description 149 
in TCAS control flow 146 
in TCAS Main Task MO diagran 138 
STAUTOCP routine 58 
(see also IKTO940C) 
STAUTOLN routine 56 
(see also IKT09409) 
STBREAK routine 54 
STC (started task control) 
in IKTCASOO PO description 149 
in TCAS control flow 146 
in TCAS Main Task MO diagram 136 
STCOM routine 55 
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STOP command 144 
STOP queue 
creation 144 
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in TCAS control block overview 172 


processing 144 
STSIZE routine 57 
(see also IKTO94OA) 
STTHPAD routine 64 
(see also IKT094614) 
STTRAN routine 61 
SVC 93 (see TGET/TPUT routines) 
SVC 94 (see terminal control macro 
routines) 
Synchronous queue 
creation 139 


in TCAS control block overview 172 


processing 140,142,144 
system-initiated cancel 14,142 


target address space TPOUT with ASID 
routine 24 
(see also IKTXMTPT) 
TCAS console comgunication 144 
TCAS termination routine 16 
(see also IKTAY81) 
TCAS main task 138 
TCAS user interface 142 
TCAS VTAM interface 140 
TCAST (TCAS table) 


allocation and initialization 138 


freeing 16,17 


in TCAS control block overview 172 
in WTIOC control block overview 124 
TCB 
in VTIOC control block overview 124 
TCLEARQ routine 53 
terminal control, transfer of 8,140 
terminal control macro routines 
introduction 1 
module names 120 
terminal I/O managers 
introduction 1 
module nages_ 120 
terminal input manager 
(see also IKTIMIDS, IKTIMLU2, IKTTIMRT) 
introduction 1 
terminal output manager 
(see also IKTOMIDS, IKTOMLU2, IKTTOMRT) 
introduction 1 
terminal output manager null RU routine 29 
(see also IKTTOMJR) 
terminal user address space termination 
routine 17 
(see also IKTAY82) 
terminals, types supported 2 
termination 
of TCAS 16,144 
of TSO/TCAM user address space 18 
of TSO/VTAM user address space 17,142 
TGET routine 20 
(see also IKTVTGET) 
TGET/TPUT routines 
introduction 1 
module names 120 
TIM (terminal input manager) 


SRB allocation and initialization 9 
TIM work area 
allocation 9 
in VfIOC control block overview 124 
TIS/TOM list 
freeing 16,1? 
TOM (terminal output manager) 
(see also IKTOMIDS, IKTTOMRT) 
introduction 1 
SRB allocation and initialization 9 
TOM work area 
allocation 9 
in VTIOC control block overview 124 
TPEND queue 
creation 
in TCAS control block overview 172 
processing 140 
TPUT with ASID routine 23,24 
(see also IKTASTPT, IKTXMTPT) 
TPUT without ASID routine 22 
(see also IKTVTPUT) 
transfer of terminal control 8,140 
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